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 返回以下状态值之一:
返回代码 | 描述 |
---|---|
|
作已成功完成。 |
|
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。
接口索引值可以在计算机重启的情况下更改。 取消注册并重新注册与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) |