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:

  • 微型端口驱动程序可以在 中获取微型端口适配器的接口索引和NET_LUID NDIS_MINIPORT_INIT_PARAMETERS 结构。
  • 筛选器驱动程序可以获取 中的筛选器模块的接口索引和NET_LUID NDIS_FILTER_ATTACH_PARAMETERS 结构。
  • 协议驱动程序可以在 NDIS_BIND_PARAMETERS 结构中获取驱动程序堆栈上最高和最低接口的接口索引和 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)

另请参阅

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MAKE_NET_LUID

NDIS_MINIPORT_INIT_PARAMETERS

NET_LUID

NdisIfGetNetLuidFromInterfaceIndex

NdisIfRegisterInterface