次の方法で共有


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 は、次のいずれかの状態値を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
操作が正常に完了しました。
NDIS_STATUS_INTERFACE_NOT_FOUND
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)

関連項目

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx