NdisIMGetBindingContext 関数 (ndis.h)

  • [アーティクル]

NdisIMGetBindingContext 関数を使用すると、NDIS プロトコル ドライバーは、上位レベルのプロトコル ドライバーがバインドされている仮想ミニポートの、基になる中間ドライバーによって作成されたデバイス コンテキスト領域にアクセスできます。

構文

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

パラメーター

[in] NdisBindingHandle

呼び出し元がバインドされている次の下位中間ドライバーの仮想ミニポートを識別する NdisBindingHandle パラメーターで NdisOpenAdapterEx 関数が返したバインディング ハンドル。

戻り値

NdisIMGetBindingContext は、指定された仮想ミニポートのデバイス コンテキスト領域へのハンドルを返します。または、このようなコンテキスト領域が存在しない場合は NULL を 返します。

注釈

プロトコル ドライバーまたは中間ドライバーは、その ProtocolBindAdapterEx 関数から NdisIMGetBindingContext を呼び出して、バインドされている仮想ミニポートのデバイス コンテキストにアクセスできます。 デバイス コンテキストは、同じ基になる中間ドライバーにバインドされているすべての上にあるプロトコル ドライバーの共通コンテキスト領域を提供します。

このようなデバイス コンテキスト領域は、下位レベルの NDIS 中間ドライバーによって割り当てられ、定義され、 への呼び出しで NDIS に渡されました NdisIMInitializeDeviceInstanceEx 関数。

NdisIMGetBindingContext を呼び出すすべてのプロトコル ドライバーは、基になる中間ドライバーが非ページ プールからコンテキスト領域を割り当てたと安全に想定できます。 返されたコンテキスト領域は読み取り専用として扱い、定義された基になる NDIS 中間ドライバーによって設定された状態を維持する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisIMGetBindingContext (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisIMGetBindingContext (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL < DISPATCH_LEVEL
DDI コンプライアンス規則 Irql_IM_Function(ndis)

こちらもご覧ください

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx