次の方法で共有


NdisIfGetInterfaceIndexFromNetLuid 関数 (ndis.h)

NdisIfGetInterfaceIndexFromNetLuid 関数は、NET_LUID 値に関連付けられているネットワーク インターフェイス インデックスを取得します。

構文

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

パラメーター

[in] NetLuid

ネットワーク インターフェイスを識別する NET_LUID 値。

[out] pIfIndex

呼び出し元が指定したインターフェイス インデックス変数へのポインター。 NdisIfGetInterfaceIndexFromNetLuid 成功した場合、NDIS は、指定したNET_LUIDに関連付けられているネットワーク インターフェイス インデックスをこの変数に書き込みます。

戻り値

NdisIfGetInterfaceIndexFromNetLuid は、次のいずれかの状態値を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
操作が正常に完了しました。
NDIS_STATUS_INTERFACE_NOT_FOUND
NdisIfGetInterfaceIndexFromNetLuid、登録されているインターフェイスの一覧に指定したNET_LUIDが存在しないために失敗しました。

備考

NDIS ドライバーは、NdisIfGetInterfaceIndexFromNetLuid 関数を呼び出して、NET_LUID 値に関連付けられているネットワーク インターフェイス インデックスを取得できます。

NDIS プロキシ プロバイダー サービスが管理するインターフェイスの場合、NDIS は、さまざまなドライバーの初期化構造でインターフェイスインデックスとNET_LUIDを提供します。

  • ミニポート ドライバーは、インターフェイスインデックスとミニポート アダプターのNET_LUIDを取得できます。 NDIS_MINIPORT_INIT_PARAMETERS 構造体。
  • フィルター ドライバーは、フィルター モジュールのインターフェイス インデックスとNET_LUIDを取得できます。 NDIS_FILTER_ATTACH_PARAMETERS 構造体。
  • プロトコル ドライバーは、NDIS_BIND_PARAMETERS 構造体のドライバー スタック上の最も高いインターフェイスと最小のインターフェイスのインデックスとNET_LUIDを取得できます。
NDIS インターフェイス プロバイダーは、NdisIfRegisterInterface 関数を呼び出すときに、ネットワーク インターフェイスにインターフェイス インデックスを割り当てます。 インターフェイス プロバイダーは、NDIS_MAKE_NET_LUID マクロを呼び出して、インターフェイスを登録する前にNET_LUID値を作成します。

インターフェイスのインデックス値は、コンピューターを再起動しなくても変更できます。 NET_LUID値に関連付けられているインターフェイスを登録解除して再登録すると、インターフェイスのインデックス値が異なる場合があります。 インターフェイス インデックスと、コンピューターの再起動後に保持されるNET_LUID インデックスを混同しないでください。

NDIS は、次の機能を提供します。NdisIfGetNetLuidFromInterfaceIndex 関数を して、指定したインターフェイス インデックスに関連付けられているNET_LUID値を取得します。

必要条件

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

関連項目

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MAKE_NET_LUID

NDIS_MINIPORT_INIT_PARAMETERS

NET_LUID

NdisIfGetNetLuidFromInterfaceIndex

NdisIfRegisterInterface