次の方法で共有

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 プロトコル ドライバーは、 NdisIfQueryBindingIfIndex 関数を 呼び出して、バインディングに関連付けられているネットワーク インターフェイスインデックスと NET_LUID 値を取得できます。

NdisIfQueryBindingIfIndex は、バインディングに関連付けられている最も高いインターフェイスと最も低いインターフェイスのNET_LUID値とインターフェイス インデックスを提供します。 これらの値は異なります。たとえば、指定したバインディングに直接関連付けられているミニポート アダプターがフィルター中間ドライバーの仮想ミニポートである場合、またはミニポート アダプター経由で構成されたフィルター モジュールがある場合などです。

プロトコル ドライバーは、NDIS_BIND_PARAMETERS構造体のドライバー スタック内の最も高いインターフェイスと最も低いインターフェイスのインターフェイス インデックスと NET_LUID を取得することもできます。

要件

要件 値
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 Irql_Interfaces_Function(ndis)

こちらもご覧ください

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx