void SetRequestedRangeSize( qUnsignedInt32 uiRangeSize );
Name | Description | |
---|---|---|
uiRangeSize | [in] Specifies the range of local IDs. When generated by IDGenerator , the ID range is initialized to that specified using SetDefaultRequestedRangeSize . If SetDefaultRequestedRangeSize has not been called even once, a default of 256 is used. |
Sets the range of IDs that can be requested of a duplication master by a duplica.
All IDGenerator
objects (including duplication masters and duplicas) hold a local pool of IDs that can each be used. Before this pool becomes empty (when about 25 IDs have been used), a local pool of new IDs is requested by the duplication master. This function sets the size of the pool. This function can be called by an IDGenerator
duplication master or duplica.
If all valid IDs in the ID pool are used up, the station requests the duplication master for a new ID pool. At this time, ID generation (the GenerateID
function) blocks for a certain amount of time (an amount of time roughly equivalent to round trip time for communication with the duplication master). The number of times this phenomena occurs can be minimized by increasing the size set here.
CONFIDENTIAL