114 lines
3.6 KiB
C
114 lines
3.6 KiB
C
|
/*++ BUILD Version: 0009 // Increment this if a change has global effects
|
|||
|
|
Copyright (c) 1987-1993 Microsoft Corporation
|
|||
|
|
|
|||
|
|
Module Name:
|
|||
|
|
|
|||
|
|
midatlas.h
|
|||
|
|
|
|||
|
|
Abstract:
|
|||
|
|
|
|||
|
|
This module defines the data structure used in mapping MIDS to the corresponding requests/
|
|||
|
|
contexts associated with them.
|
|||
|
|
|
|||
|
|
Author:
|
|||
|
|
|
|||
|
|
Balan Sethu Raman (SethuR) 26-Aug-95 Created
|
|||
|
|
|
|||
|
|
Notes:
|
|||
|
|
|
|||
|
|
MID (Multiplex ID) is used at both the server and the client ( redirector ) to distinguish
|
|||
|
|
between the concurrently active requests on any connection. This data structure has been
|
|||
|
|
designed to meet the following criterion.
|
|||
|
|
|
|||
|
|
1) It should scale well to handle the differing capabilities of a server, e.g., the typical
|
|||
|
|
NT server permits 50 outstanding requests on any connection. The CORE level servers can go as
|
|||
|
|
low as one and on Gateway machines the desired number can be very high ( in the oreder of thousands)
|
|||
|
|
|
|||
|
|
2) The two primary operations that need to be handled well are
|
|||
|
|
i) mapping a MID to the context associated with it.
|
|||
|
|
-- This routine will be invoked to process every packet received along any connection
|
|||
|
|
at both the server and the client.
|
|||
|
|
ii) generating a new MID for sending requests to the server.
|
|||
|
|
-- This will be used at the client both for max. command enforcement as well as
|
|||
|
|
tagging each concurrent request with a unique id.
|
|||
|
|
|
|||
|
|
The most common case is that of a connection between a NT client and a NT server. All
|
|||
|
|
design decisions have been made in order to ensure that the solutions are optimal
|
|||
|
|
for this case.
|
|||
|
|
|
|||
|
|
The MID data structure must be efficiently able to manage the unique tagging and identification
|
|||
|
|
of a number of mids ( typically 50 ) from a possible combination of 65536 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 upinto three bit fields. The length of the
|
|||
|
|
rightmost field ( least signifiant ) is decided by the number of mids that are to be
|
|||
|
|
allocated on creation. The remaining length is split up equally between the next two
|
|||
|
|
fields, e.g., if 50 mids are to be allocated on creation , the length of the first field
|
|||
|
|
is 6 ( 64 ( 2 ** 6 ) is greater than 50 ), 5 and 5.
|
|||
|
|
|
|||
|
|
--*/
|
|||
|
|
|
|||
|
|
#ifndef _MIDATLAX_H_
|
|||
|
|
#define _MIDATLAX_H_
|
|||
|
|
|
|||
|
|
typedef struct _RX_MID_ATLAS {
|
|||
|
|
USHORT MaximumNumberOfMids;
|
|||
|
|
USHORT MidsAllocated;
|
|||
|
|
USHORT NumberOfMidsInUse;
|
|||
|
|
USHORT NumberOfMidsDiscarded;
|
|||
|
|
USHORT MaximumMidFieldWidth;
|
|||
|
|
USHORT Reserved;
|
|||
|
|
USHORT MidQuantum;
|
|||
|
|
UCHAR MidQuantumFieldWidth;
|
|||
|
|
UCHAR NumberOfLevels;
|
|||
|
|
LIST_ENTRY MidMapFreeList;
|
|||
|
|
LIST_ENTRY MidMapExpansionList;
|
|||
|
|
struct _MID_MAP_ *pRootMidMap;
|
|||
|
|
} RX_MID_ATLAS, *PRX_MID_ATLAS;
|
|||
|
|
|
|||
|
|
typedef
|
|||
|
|
VOID (*PCONTEXT_DESTRUCTOR)(
|
|||
|
|
PVOID pContext);
|
|||
|
|
|
|||
|
|
#define RxGetMaximumNumberOfMids(pMidAtlas) \
|
|||
|
|
((pMidAtlas)->MaximumNumberOfMids)
|
|||
|
|
|
|||
|
|
#define RxGetNumberOfMidsInUse(pMidAtlas) \
|
|||
|
|
((pMidAtlas)->NumberOfMidsInUse)
|
|||
|
|
|
|||
|
|
PRX_MID_ATLAS
|
|||
|
|
RxCreateMidAtlas(
|
|||
|
|
USHORT MaximumNumberOfEntries,
|
|||
|
|
USHORT InitialAllocation);
|
|||
|
|
|
|||
|
|
VOID
|
|||
|
|
RxDestroyMidAtlas(
|
|||
|
|
PRX_MID_ATLAS pMidAtlas,
|
|||
|
|
PCONTEXT_DESTRUCTOR pContextDestructor);
|
|||
|
|
|
|||
|
|
PVOID
|
|||
|
|
RxMapMidToContext(
|
|||
|
|
PRX_MID_ATLAS pMidAtlas,
|
|||
|
|
USHORT Mid);
|
|||
|
|
|
|||
|
|
NTSTATUS
|
|||
|
|
RxAssociateContextWithMid(
|
|||
|
|
PRX_MID_ATLAS pMidAtlas,
|
|||
|
|
PVOID pContext,
|
|||
|
|
PUSHORT pNewMid);
|
|||
|
|
|
|||
|
|
NTSTATUS
|
|||
|
|
RxMapAndDissociateMidFromContext(
|
|||
|
|
PRX_MID_ATLAS pMidAtlas,
|
|||
|
|
USHORT Mid,
|
|||
|
|
PVOID *pContextPointer);
|
|||
|
|
|
|||
|
|
NTSTATUS
|
|||
|
|
RxReassociateMid(
|
|||
|
|
PRX_MID_ATLAS pMidAtlas,
|
|||
|
|
USHORT Mid,
|
|||
|
|
PVOID pNewContext);
|
|||
|
|
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
|