NdisIfGetNetLuidFromInterfaceIndex 函式 (ndis.h)

NdisIfGetNetLuidFromInterfaceIndex 函式會取得與網路介面索引相關聯的NET_LUID值。

語法

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

ifIndex

指派給中 NET_LUID 值的 NDIS 網路介面索引 NdisIfRegisterInterface 函式。

[out] pNetLuid

呼叫端提供的NET_LUID變數指標。如果 NdisIfGetNetLuidFromInterfaceIndex 成功，NDIS 會將與指定網路介面索引相關聯的NET_LUID值寫入此變數。

NdisIfGetNetLuidFromInterfaceIndex 會傳回下列其中一個狀態值：

傳回碼	Description
NDIS_STATUS_SUCCESS	作業已成功完成。
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetNetLuidFromInterfaceIndex 失敗，因為指定的網路介面索引未指派給已註冊的介面。

NDIS 驅動程式可以呼叫 NdisIfGetNetLuidFromInterfaceIndex 函式，以取得與網路介面索引相關聯的 NET_LUID 值。

針對 NDIS Proxy 提供者服務所管理的介面，NDIS 會在各種驅動程式初始化結構中提供介面索引和NET_LUID：

當介面提供者呼叫 NdisIfRegisterInterface 函式時，NDIS 會將介面索引指派給網路介面。介面提供者會呼叫 NDIS_MAKE_NET_LUID 宏，在宏註冊介面之前先建立NET_LUID值。

介面索引值可以在不重新啟動計算機的情況下變更。取消註冊並重新註冊與NET_LUID值相關聯的介面可能會導致不同的介面索引值。請勿將介面索引與計算機重新啟動後所保存NET_LUID索引混淆。

NDIS 提供 NdisIfGetInterfaceIndexFromNetLuid 函式，以取得指定之NET_LUID的介面索引。

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_Interfaces_Function (ndis)