Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

RxCreateMidAtlas function

RxCreateMidAtlas allocates a new instance of MID_ATLAS data structure and initializes it.

Syntax


PRX_MID_ATLAS RxCreateMidAtlas(
   USHORT MaximumNumberOfMids,
   USHORT MidsAllocatedAtStart
);

Parameters

MaximumNumberOfMids

The maximum number of multiplex IDs (MIDs) to be allowed in the atlas.

MidsAllocatedAtStart

The number of multiplex IDs allocated initially.

Return value

RxCreateMidAtlas returns a pointer to allocated and initialized MID_ATLAS data structure on success or a NULL pointer on failure.

Remarks

RDBSS defines a Multiplex ID (MID), a 16-bit value, that can be used by both the network client (mini-redirector) and the server to distinguish between the concurrently active requests on any connection.

The MID must be efficiently able to manage the unique tagging and identification of a number of MIDs (typically 50) from a possible combination of 65,536 values. In order to ensure a proper time space tradeoff, the lookup is organized as a three level hierarchy. The 16 bits used to represent a MID are split up into three bitfields. The length of the rightmost field (least significant ) is decided by the maximum number of MIDs that are to be allowed in the atlas. This maximum value is a parameter passed to RxCreateMidAtlas when the MID_ATLAS data structure is created. The remaining length is split up equally between the next two fields.

For example, if a maximum of 50 MIDs are to be allocated on creation , the length of the first field is 6 (64 ( 2 ** 6 ) is greater than 50 ). The remaining length is split into two fields of 5 bits each.

RxCreateMidAtlas allocates non-paged pool memory when creating a new MID_ATLAS data structure.

Requirements

Target platform

Desktop

Header

Midatlax.h (include Midatlax.h)

IRQL

<= APC_LEVEL

See also

RxAssociateContextWithMid
RxDestroyMidAtlas
RxMapMidToContext
RxMapAndDissociateMidFromContext
RxReassociateMid

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft