通过

NdisIfQueryBindingIfIndex 函数 （ndis.h）

  • 项目

NdisIfQueryBindingIfIndex 函数检索与指定协议绑定关联的最高和最低分层网络接口的网络接口索引和 NET_LUID 值。

语法

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

参数

[in] NdisBindingHandle

一个句柄，用于标识 NDIS 应为其获取 NET_LUID 值和网络接口索引的绑定。 NDIS 在 NdisOpenAdapterEx 函数的 NdisBindingHandle 参数中提供了此句柄。

[out] pBoundIfIndex

指向调用方提供的接口索引变量的指针。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 会将此变量写入与指定绑定关联的网络接口的网络接口索引，并在驱动程序堆栈中最高。

[out] pBoundIfNetLuid

指向调用方提供的NET_LUID变量的指针。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 会将此变量写入与指定绑定关联的网络接口NET_LUID值，并在驱动程序堆栈中最高。

[out] pLowestIfIndex

指向调用方提供的接口索引变量的指针。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 会将此变量写入与指定绑定关联的网络接口的网络接口索引，并且驱动程序堆栈中最低。

[out] pLowestIfNetLuid

指向调用方提供的NET_LUID变量的指针。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 会将此变量写入与指定绑定关联的网络接口的NET_LUID值，并且驱动程序堆栈中最低。

返回值

NdisIfQueryBindingIfIndex 返回以下状态值之一：

返回代码 描述
NDIS_STATUS_SUCCESS
 作已成功完成。
NDIS_STATUS_INTERFACE_NOT_FOUND
 NdisIfQueryBindingIfIndex 失败，因为指定的绑定未与已注册的接口关联。

言论

NDIS 协议驱动程序可以调用 NdisIfQueryBindingIfIndex 函数来检索与绑定关联的网络接口索引和 NET_LUID 值。

NdisIfQueryBindingIfIndex 为与绑定关联的最高接口和最低接口提供NET_LUID值和接口索引。 例如，如果与指定绑定直接关联的微型端口适配器是筛选器中间驱动程序的虚拟微型端口，或者存在通过微型端口适配器配置的筛选器模块，则这些值会有所不同。

协议驱动程序还可以获取 NDIS_BIND_PARAMETERS 结构中驱动程序堆栈中最高接口和最低接口的接口索引和NET_LUID。

要求

要求 价值
最低支持的客户端 NDIS 6.0 及更高版本中受支持。
目标平台 桌面
标头 ndis.h （包括 Ndis.h）
库 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Interfaces_Function（ndis）

另请参阅

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx