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)
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