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)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Interfaces_Function (ndis)

另请参阅

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx