RxAssociateContextWithMid 関数 (midatlax.h)

[アーティクル]
02/27/2024

RxAssociateContextWithMid は 、指定された不透明なコンテキストを、MID_ATLASから使用可能な多重 ID (MID) に関連付けます。

構文

NTSTATUS RxAssociateContextWithMid(
  PRX_MID_ATLAS MidAtlas,
  PVOID         Context,
  PUSHORT       NewMid
);

パラメーター

MidAtlas

MID_ATLASデータ構造へのポインター。

Context

コンテキストへのポインター。

NewMid

コンテキストに関連付ける多重 ID へのポインター。

戻り値

RxAssociateContextWithMid は 、成功した場合にSTATUS_SUCCESSを返すか、次のいずれかのエラー値を返します。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	このエラーは、新しいMID_MAPデータ構造に十分なメモリを割り当てられなかった場合に返されます。
STATUS_UNSUCCESSFUL	このエラーは、既に使用されている MID の数が、MID_ATLAS構造体の作成時に設定された MID の最大数を超える場合など、いくつかのケースで返されます。

注釈

RDBSS では、ネットワーククライアント (ミニリダイレクター) とサーバーの両方で使用できるマルチプレックス ID (MID) (16 ビット値) を定義し、任意の接続で同時にアクティブな要求を区別できます。 MID は、 RxCreateMidAtlas を呼び出して割り当てられたMID_ATLASデータ構造のコンポーネントです。 MID_MAPデータ構造が割り当てられ、MID をRX_CONTEXTデータ構造にマッピングするために使用されます。 RxAssociateContextWithMid は 、新しいMID_MAPデータ構造を作成するときに、ページ以外のプールメモリを割り当てます。

pContext パラメーターは、任意の不透明なコンテキストにすることができますが、通常はRX_CONTEXTです。