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

NdisIfGetInterfaceIndexFromNetLuid

NdisIfRegisterInterface