NdisIfGetInterfaceIndexFromNetLuid 関数 (ndis.h)

[アーティクル]
03/05/2024

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

要件

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