NdisIfGetNetLuidFromInterfaceIndex 関数 (ndis.h)

[アーティクル]
08/07/2023

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

構文

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

パラメーター

ifIndex

NDIS がの NET_LUID 値に割り当てたネットワークインターフェイスインデックス NdisIfRegisterInterface 関数。

[out] pNetLuid

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

戻り値

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

リターンコード	説明
NDIS_STATUS_SUCCESS	操作は正常に完了しました。
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetNetLuidFromInterfaceIndex が失敗しました。これは、指定されたネットワークインターフェイスインデックスが登録済みインターフェイスに割り当てられないためです。

注釈

NDIS ドライバーは、 NdisIfGetNetLuidFromInterfaceIndex 関数を呼び出して、ネットワークインターフェイスインデックスに関連付けられている 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のインターフェイスインデックスを取得する NdisIfGetInterfaceIndexFromNetLuid 関数。

要件

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