структура DOT11_WFD_DISCOVER_REQUEST (windot11.h)
Важный
WiFiCx — это новая модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Модель драйвера WDI теперь находится в режиме обслуживания и получит только исправления с высоким приоритетом.
Структура OID_DOT11_WFD_DISCOVER_REQUEST — это входные данные для запроса OID_DOT11_WFD_DISCOVER_REQUEST. Структура содержит параметры для обнаружения Wi-Fi прямого устройства.
Синтаксис
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.
Минипорт-драйвер должен задать члены заголовка следующими значениями:
Тип
Этот элемент должен иметь значение 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, которое указывает устройства P2P и владельцы групп для поиска во время обнаружения Wi-Fi Direct. Это смещение указывается в байтах и относительно начала буфера, содержащего структуру DOT11_WFD_DISCOVER_REQUEST. Каждая запись в списке форматируется как DOT11_WFD_DISCOVER_DEVICE_FILTER.
Если запись списка указывает невещательный MAC-адрес в качестве идентификатора устройства, драйвер должен использовать этот MAC-адрес в атрибуте идентификатора устройства P2P, который он включает в запросы пробы.
Смещение в InformationBufferNDIS_OID_REQUEST, где начинается список идентификаторов устройств P2P. Это идентификаторы для во время обнаружения устройств.
uNumDeviceFilters
Количество фильтров устройств P2P, используемых во время обнаружения устройств WFD. Значение по умолчанию для этого поля равно 0.
uIEsOffset
Смещение в InformationBuffer структуры NDIS_OID_REQUEST, где начинаются дополнительные информационные элементы (IEs).
uIEsLength
Длина (в байтах) дополнительных идентификаторов, которые должен добавить порт Wi-Fi Direct device в пакет запроса пробы. Если это значение равно 0, система не предоставила никаких IEs и минипорт должен вставить идентификаторы по умолчанию в пакет запроса пробы. IEs по умолчанию находятся в DefaultRequestIEs полученных ранее с запросом OID_DOT11_WFD_ADDITIONAL_IE.
bForceScanLegacyNetworks
Если значение TRUE, устройство Wi-Fi Direct также должно попытаться обнаружить устаревшие сети. В противном случае сканирование устаревших сетей не требуется.
Замечания
Каждая запись в списке идентификаторов устройства в uDeviceFilterListOffset форматируется как структура DOT11_MAC_ADDRESS. Если в этом списке указан невещательный MAC-адрес, драйвер должен использовать этот адрес в атрибуте идентификатора устройства пробы P2P IEs, который он передает.
IEs, присутствующих в uIEsOffset, на протяжении всего времени обнаружения устройства, временно заменит IEs, найденные в DefaultRequestIEs в входной структуре запроса OID_DOT11_WFD_ADDITIONAL_IE.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Версии:_Supported в Windows 8 |
| заголовка | windot11.h (включая Windot11.h) |