次の方法で共有


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