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：

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

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

NDIS 提供 NdisIfGetNetLuidFromInterfaceIndex 函数，用于获取与指定接口索引关联的NET_LUID值。

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