windot11.h) (DOT11_WFD_DISCOVER_REQUEST 结构
语法
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) |