次の方法で共有


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

要件

要件
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library 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