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 Proxy 提供者服務所管理的介面，NDIS 會在各種驅動程式初始化結構中提供介面索引和NET_LUID：

當介面提供者呼叫 NdisIfRegisterInterface 函式時，NDIS 會將介面索引指派給網路介面。介面提供者會呼叫 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）