NdisIfQueryBindingIfIndex 関数 (ndis.h)
NdisIfQueryBindingIfIndex 関数は、指定されたプロトコル バインディングに関連付けられている最上位および最下位のレイヤード ネットワーク インターフェイスのネットワーク インターフェイス インデックスと NET_LUID 値を取得します。
構文
NDIS_STATUS NdisIfQueryBindingIfIndex(
[in] NDIS_HANDLE NdisBindingHandle,
[out] PNET_IFINDEX pBoundIfIndex,
[out] PNET_LUID pBoundIfNetLuid,
[out] PNET_IFINDEX pLowestIfIndex,
[out] PNET_LUID pLowestIfNetLuid
);
パラメーター
[in] NdisBindingHandle
NDIS が NET_LUID 値とネットワーク インターフェイスインデックスを取得する必要があるバインディングを識別するハンドル。 NDIS は、NdisOpenAdapterEx 関数の NdisBindingHandle パラメーターでこのハンドルを提供しました。
[out] pBoundIfIndex
呼び出し元が指定したインターフェイス インデックス変数へのポインター。 NdisIfQueryBindingIfIndex 成功した場合、NDIS は、指定されたバインディングに関連付けられている、ドライバー スタックで最も高いネットワーク インターフェイスのネットワーク インターフェイス インデックスをこの変数に書き込みます。
[out] pBoundIfNetLuid
呼び出し元が指定したNET_LUID変数へのポインター。 NdisIfQueryBindingIfIndex 成功した場合、NDIS は、指定されたバインディングに関連付けられている、ドライバー スタックで最も高いネットワーク インターフェイスのNET_LUID値をこの変数に書き込みます。
[out] pLowestIfIndex
呼び出し元が指定したインターフェイス インデックス変数へのポインター。 NdisIfQueryBindingIfIndex 成功した場合、NDIS は、指定されたバインディングに関連付けられている、ドライバー スタックで最も低いネットワーク インターフェイスのネットワーク インターフェイス インデックスをこの変数に書き込みます。
[out] pLowestIfNetLuid
呼び出し元が指定したNET_LUID変数へのポインター。 NdisIfQueryBindingIfIndex 成功した場合、NDIS は、指定されたバインディングに関連付けられている、ドライバー スタックで最も低いネットワーク インターフェイスのNET_LUID値をこの変数に書き込みます。
戻り値
NdisIfQueryBindingIfIndex は、次のいずれかの状態値を返します。
リターン コード | 形容 |
---|---|
|
操作が正常に完了しました。 |
|
NdisIfQueryBindingIfIndex、指定したバインディングが登録済みインターフェイスに関連付けられていないため失敗しました。 |
備考
NDIS プロトコル ドライバーは、ネットワーク インターフェイスインデックスとバインドに関連付けられている NET_LUID 値を取得する NdisIfQueryBindingIfIndex 関数を呼び出すことができます。
NdisIfQueryBindingIfIndex は、バインディングに関連付けられている最も高いインターフェイスと最も低いインターフェイスのNET_LUID値とインターフェイス インデックスを提供します。 これらの値は異なります。たとえば、指定されたバインディングに直接関連付けられているミニポート アダプターがフィルター中間ドライバーの仮想ミニポートであるか、ミニポート アダプター経由で構成されているフィルター モジュールがある場合などです。
プロトコル ドライバーは、NDIS_BIND_PARAMETERS 構造体のドライバー スタック内で最も高く、最も低いインターフェイスのインターフェイス インデックスとNET_LUIDを取得することもできます。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | ndis.h (Ndis.h を含む) |
ライブラリ | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI コンプライアンス規則 を する | Irql_Interfaces_Function(ndis) |
関連項目
NdisOpenAdapterEx の