RxCreateMidAtlas 関数 (midatlax.h)

[アーティクル]
03/05/2024

RxCreateMidAtlas は、データ構造の新しいインスタンスMID_ATLAS割り当てて初期化します。

構文

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

パラメーター

MaximumNumberOfEntries

atlas で許可される多重 ID (MID) の最大数。

InitialAllocation

最初に割り当てられた多重 ID の数。

戻り値

RxCreateMidAtlas は、成功した場合はデータ構造MID_ATLAS割り当てられ、初期化されたへのポインター、または失敗した場合は NULL ポインターを返します。

注釈

RDBSS では、ネットワーククライアント (ミニリダイレクター) とサーバーの両方で使用できる 16 ビット値である多重 ID (MID) を定義し、任意の接続で同時にアクティブな要求を区別できます。

MID は、65,536 個の値の可能な組み合わせから、多数の MID (通常は 50) の一意のタグ付けと識別を効率的に管理できる必要があります。適切な時間空間のトレードオフを確保するために、ルックアップは 3 つのレベル階層として編成されます。 MID を表すために使用される 16 ビットは、3 つのビットフィールドに分割されます。右端のフィールド (最下位) の長さは、atlas で許可される MID の最大数によって決められます。この最大値は、MID_ATLAS データ構造の作成時に RxCreateMidAtlas に渡されるパラメーターです。残りの長さは、次の 2 つのフィールド間で均等に分割されます。

たとえば、作成時に最大 50 個の MID を割り当てる場合、最初のフィールドの長さは 6 です (64 ( 2 ** 6 ) は 50 を超えています)。残りの長さは、それぞれ 5 ビットの 2 つのフィールドに分割されます。

RxCreateMidAtlas は、新しいMID_ATLASデータ構造を作成するときに、ページ以外のプールメモリを割り当てます。