|
Initial Setup Properties |
||
|
Methods |
||
Overview
The ResourcePool control is used to collect voice/fax resources into a pool for allocation purposes. When a resource is required, it is allocated out of a specified pool.
Each pool may be used for a different purpose. For example, pool A may be reserved for incoming calls, whereas pool B may be used for station sets. TapRecord control is getting resources to be used for recording from a ResourcePool. Resources can be added at design time or added by code, depending on the application's requirements at runtime.
Each control does contain only one type of resources, either voice or fax. This must be decided at design type and cannot be changed at runtime.
Applicability
These controls are designed to be used with Intel cards of DM3 architecture, (using the card type=Intel from within VBVConfig), or Intel Host Media Processing (HMP), using type=IntelHMP. Currently they are not supported on other cards.
For Dialogic cards used with card type=Dialogic, the old dynamic resource controls (ResourceGroup, GetResource, FreeResource) should be used. These two sets of resource allocation controls could not be mixed. A system check would detect whether there are mixed controls and would prevent the voice system to start.
Implementation
From within the Visual Basic 6 environment:
Add "Pronexus Resources Allocation Controls" (VBVResources.ocx) to the project's components.
From within the Visual Studio .NET 2003 environment:
Add a reference to VBVRESOURCESLib.dll (if you need access to vbvResourceTypeConstants constants), otherwise no other action is required.
Runtime Properties
Integer (read-only)
Returns the number of free resources in the group. Its value is 0 if the system is not started or there are not free resources in the pool.
Integer (read-only)
Returns the number of resources in the pool. Its value is 0 if the system is not started or there are no resources in the pool.
NumOfUnmanagedResources(type As vbvResourceTypeConstants)
Integer (read-only)
Returns the number of resources currently in the global pool, from which some could be added to ResourcePool controls.
vbvResourceTypeConstants (read-only)
Returns the type of the resources in the resource pool. It is a read only property. The type of the resources in the pool can be set only at design time.
TotalNumOfResouces (type As vbvResourceTypeConstants )
Integer (read-only)
Returns the total number of the resources of a certain type in the system.
Methods
AddResources( nrOfResources As Integer) As Integer
Add the specified number of resources into the current resource pool. Returns the number of resources successfully added.
RemoveResources( nrOfResources As Integer) As Integer
Remove the specified number of resources from the current resource pool. Returns the number of resources successfully removed.
Setup Property Page
Initial Number of Resources in the Pool
Determines the initial available number of resources.
Resource Type
Determines the type (vbvResourceTypeConstants) of available resources.