NdisIfGetNetLuidFromInterfaceIndex 函数 (ndis.h)

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：

当接口提供程序调用 NdisIfRegisterInterface 函数时，NDIS 会将接口索引分配给网络接口。接口提供程序调用 NDIS_MAKE_NET_LUID 宏以在注册接口之前创建NET_LUID值。

接口索引值可以在不重启计算机的情况下更改。取消注册和重新注册与NET_LUID值关联的接口可能会导致不同的接口索引值。不要将接口索引与计算机重启后保留的NET_LUID索引混淆。

NDIS 提供 NdisIfGetInterfaceIndexFromNetLuid 函数，用于获取指定NET_LUID的接口索引。

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
目标平台	桌面
标头	ndis.h (包括 Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 符合性规则	Irql_Interfaces_Function (ndis)