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 返回以下状态值之一：
| 返回代码 | 说明 |
|---|---|
|
操作已成功完成。 |
|
NdisIfGetNetLuidFromInterfaceIndex 失败，因为指定的网络接口索引未分配给已注册的接口。 |
注解
NDIS 驱动程序可以调用 NdisIfGetNetLuidFromInterfaceIndex 函数来获取与网络接口索引关联的 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 提供 NdisIfGetInterfaceIndexFromNetLuid 函数，用于获取指定NET_LUID的接口索引。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h (包括 Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | Irql_Interfaces_Function (ndis) |