次の方法で共有


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) を参照) でサポートされています。
ターゲット プラットフォーム デスクトップ
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL < DISPATCH_LEVEL
DDI コンプライアンス規則 する Irql_IM_Function(ndis)

関連項目

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx