WIFI_WIFIDIRECT_CAPABILITIES 结构描述了 WiFiCx 设备的 Wi-Fi 直接功能。
语法
typedef struct _WIFI_WIFIDIRECT_CAPABILITIES {
ULONG Size;
UINT8 WFDRoleCount;
UINT8 ConcurrentGOCount;
UINT8 ConcurrentClientCount;
BOOLEAN ServiceDiscoverySupported;
BOOLEAN ServiceNameDiscoverySupported;
BOOLEAN ServiceInformationDiscoverySupported;
UINT32 ServiceNameAdvertisementsMaxBytesSupported;
UINT32 ServiceInformationAdvertisementsMaxBytesSupported;
BOOLEAN BackgroundDiscoverySupported;
BOOLEAN ClientDiscoverabilitySupported;
BOOLEAN InfrastructureManagementSupported;
UINT8 DeviceAddress[6];
UINT32 DiscoveryFilterListSize;
UINT8 GOClientTableSize;
UINT32 MaxVendorSpecificExtensionIESize;
BOOLEAN PassiveAvailabilityListenStateSupported;
BOOLEAN OperatingChannelUpdatesSupported;
BOOLEAN GOon5GHzBandSupported;
UINT32 ScanSSIDListSize;
UINT32 DesiredSSIDListSize;
UINT32 PrivacyExemptionListSize;
UINT32 AssociationTableSize;
UINT32 DefaultKeyTableSize;
UINT32 WEPKeyValueMaxLength;
UINT32 NumSupportedUnicastAlgorithms;
PDOT11_AUTH_CIPHER_PAIR UnicastAlgorithms;
UINT32 NumSupportedMulticastDataAlgorithms;
PDOT11_AUTH_CIPHER_PAIR MulticastDataAlgorithms;
UINT32 NumInterfaceAddresses;
WDI_MAC_ADDRESS *InterfaceAddressList;
BOOLEAN GOon6GHzBandSupported;
} WIFI_WIFIDIRECT_CAPABILITIES;
成员
Size
所有包含元素的大小的总和(以字节为单位)。
WFDRoleCount
支持 Wi-Fi 直接角色端口的数目
ConcurrentGOCount
指定并发组所有者计数。
ConcurrentClientCount
指定并发客户端计数。
ServiceDiscoverySupported
指定是否支持服务发现。 有效值为 0(不支持)和 1(支持)。
ServiceNameDiscoverySupported
Wi-Fi 直接服务名称发现支持。 指定在给定服务名称哈希列表时,适配器是否可以探测服务哈希,并在响应到达时指示响应。 有效值为 0(不支持)和 1(支持)。
ServiceInformationDiscoverySupported
Wi-Fi 直接服务信息发现支持。 指定在给定服务名称哈希列表时,适配器是否可以执行探测和 ANQP 查询以获取完整的服务信息。 有效值为 0(不支持)和 1(支持)。
ServiceNameAdvertisementsMaxBytesSupported
指定要在信标和探测响应中发送的服务名称播发字节数上限。 这会对可播发的服务数设置硬性限制。
ServiceInformationAdvertisementsMaxBytesSupported
指定适配器可以使用 GAS 协议响应的服务信息播发字节数上限。 仅当设备支持响应服务播发查询时,这才有效。 此值用于固件优化,以便固件不会唤醒主机以响应每个查询。 如果固件存在限制,则作系统不会限制服务播发的数量,因为作系统中有回退。 如果固件无法处理 ANQP 查询响应,则应传递请求,作系统处理请求。
BackgroundDiscoverySupported
Wi-Fi 直接设备和服务的后台发现。 指定适配器是否可以定期查询 Wi-Fi Direct 设备和服务名称,以便任何新设备在变为可见后的 5 分钟内显示。 有效值为 0(不支持)和 1(支持)。
ClientDiscoverabilitySupported
指定是否支持客户端可发现性。 有效值为 0(不支持)和 1(支持)。
InfrastructureManagementSupported
指定是否支持基础结构管理。 有效值为 0(不支持)和 1(支持)。
DeviceAddress[6]
按网络字节顺序排列的设备地址。
DiscoveryFilterListSize
发现筛选器列表大小。
GOClientTableSize
GO 客户端表大小。
MaxVendorSpecificExtensionIESize
可以添加到 WFD 管理帧的供应商特定扩展 IDE 的最大大小(以字节为单位)。
PassiveAvailabilityListenStateSupported
指定是否支持在后台侦听 P2P 服务。 有效值为 0(不支持)和 1(支持)。
OperatingChannelUpdatesSupported
指定适配器是否支持指示 GO作通道的更新。 有效值为 0(不支持)和 1(支持)。
GOon5GHzBandSupported
指定适配器是否支持在 5GHz 带上运行 GO。 有效值为 0(不支持)和 1(支持)。
ScanSSIDListSize
扫描 SSID 列表大小。
DesiredSSIDListSize
所需的 SSID 列表大小。
PrivacyExemptionListSize
隐私豁免列表大小。
AssociationTableSize
关联表大小。
DefaultKeyTableSize
默认键表大小。
WEPKeyValueMaxLength
WEP 键值的最大长度。
NumSupportedUnicastAlgorithms
支持的单播算法数。
UnicastAlgorithms
指向格式化为 DOT11_AUTH_CIPHER_PAIR 结构的单播密码算法数组的指针。 此数组的长度由 NumSupportedUnicastAlgorithms 成员指定。
NumSupportedMulticastDataAlgorithms
支持的多播数据密码算法数。
MulticastDataAlgorithms
指向多播数据密码算法数组的指针,这些算法格式化为 DOT11_AUTH_CIPHER_PAIR 结构。 此数组的长度由 NumSupportedMulticastDataAlgorithms 成员指定。
NumInterfaceAddresses
支持的接口地址数。
InterfaceAddressList
指向格式化为 WDI_MAC_ADDRESS 结构的接口地址数组的指针。 此数组的长度由 NumInterfaceAddresses 成员指定。
GOon6GHzBandSupported
一个 BOOLEAN 值,该值指定适配器是否支持在 6GHz 带上运行 GO。 有效值为 0(不支持)和 1(支持)。
言论
调用 WIFI_WIFIDIRECT_CAPABILITIES_INIT 初始化此结构,并填写其 大小 字段。 然后调用 WifiDeviceSetWiFiDirectCapabilities,将 Wi-Fi Direct 功能报告给 WiFiCx。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 11 |
| 支持的最低服务器 | Windows Server 2022 |
| 标头 | wificx.h |