windot11.h) (DOT11_WFD_DISCOVER_REQUEST 结构

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

 

OID_DOT11_WFD_DISCOVER_REQUEST结构是OID_DOT11_WFD_DISCOVER_REQUEST请求的输入数据。 结构包含 Wi-Fi Direct 设备发现的参数。

语法

typedef struct _DOT11_WFD_DISCOVER_REQUEST {
  NDIS_OBJECT_HEADER      Header;
  DOT11_WFD_DISCOVER_TYPE DiscoverType;
  DOT11_WFD_SCAN_TYPE     ScanType;
  ULONG                   uDiscoverTimeout;
  ULONG                   uDeviceFilterListOffset;
  ULONG                   uNumDeviceFilters;
  ULONG                   uIEsOffset;
  ULONG                   uIEsLength;
  BOOLEAN                 bForceScanLegacyNetworks;
} DOT11_WFD_DISCOVER_REQUEST, *PDOT11_WFD_DISCOVER_REQUEST;

成员

Header

OID_DOT11_WFD_DISCOVER_REQUEST 结构的类型、修订和大小。 此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的成员设置为以下值：

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。

修订

此成员必须设置为 DOT11_WFD_DISCOVER_REQUEST_REVISION_1。

大小

此成员必须设置为 sizeof (DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1) 。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

DiscoverType

要使用的设备发现模式。

ScanType

在设备发现的扫描阶段使用的扫描类型。

uDiscoverTimeout

完成发现操作的最长时间（以毫秒为单位）。 微型端口可以在更短的时间内完成发现，但是，它使用的时间不应超过此值指定的时间。 这是完成设备发现的所有阶段所允许的总时间。

uDeviceFilterListOffset

P2P 设备筛选器列表的偏移量，该筛选器指定要在 Wi-Fi Direct 设备发现期间搜索的 P2P 设备和组所有者。 此偏移量以字节为单位指定，相对于包含 DOT11_WFD_DISCOVER_REQUEST 结构的缓冲区的起始位置。 列表中的每个条目的格式设置为DOT11_WFD_DISCOVER_DEVICE_FILTER。

当列表条目将非广播 MAC 地址指定为设备 ID 时，驱动程序必须在它包含在探测请求中的 P2P IDE 的设备 ID 属性中使用此 MAC 地址。

NDIS_OID_REQUEST P2P 设备标识符列表开始处的 InformationBuffer 中的偏移量。 这些是在设备发现期间对 的标识符。

uNumDeviceFilters

在 WFD 设备发现期间要使用的 P2P 设备筛选器数。 此字段的默认值为 0。

uIEsOffset

NDIS_OID_REQUEST 结构的 InformationBuffer 中的偏移量，其中附加信息元素 (ES) 开始。

uIEsLength

Wi-Fi Direct 设备端口必须添加到探测请求数据包的其他 IDE 的长度（以字节为单位）。 如果此值为 0，则表示系统未提供任何 IDE，微型端口必须在探测请求数据包中插入默认的 IDE。 默认 IE 位于前面收到的具有OID_DOT11_WFD_ADDITIONAL_IE请求的DefaultRequestIEs 中。

bForceScanLegacyNetworks

如果为 TRUE，Wi-Fi Direct 设备还必须尝试发现旧网络。 否则，不需要扫描旧网络。

注解

uDeviceFilterListOffset 处的设备标识符列表中的每个条目都格式化为DOT11_MAC_ADDRESS结构。 在此列表中指定非广播 MAC 地址时，驱动程序必须在它传输的 P2P IDE 探测请求的“设备 ID”属性中使用此地址

在设备发现期间，uIEsOffset 中存在的 IDE 将暂时替换在 OID_DOT11_WFD_ADDITIONAL_IE 请求的输入结构中的 DefaultRequestIEs 中找到的 IDE。

要求

要求	值
最低受支持的客户端	版本：Windows 8 中的_Supported
标头	windot11.h (包括 Windot11.h)

另请参阅

OID_DOT11_WFD_DISCOVER_REQUEST

DOT11_WFD_SCAN_TYPE

DOT11_WFD_DISCOVER_TYPE

NDIS_OBJECT_HEADER