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) |