структура DOT11_WFD_DISCOVER_REQUEST (windot11.h)

Статья
08/08/2023

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (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, в котором указываются устройства P2P и владельцы групп, которые нужно искать во время Wi-Fi прямого обнаружения устройств. Это смещение указывается в байтах и относительно начала буфера, содержащего структуру DOT11_WFD_DISCOVER_REQUEST. Каждая запись в списке отформатирована как DOT11_WFD_DISCOVER_DEVICE_FILTER.

Если в записи списка в качестве идентификатора устройства указан не широковещательный MAC-адрес, драйвер должен использовать этот MAC-адрес в атрибуте идентификатора устройства ip-адресов P2P, которые он включает в запросы пробы.

Смещение в InformationBufferNDIS_OID_REQUEST с которого начинается список идентификаторов устройств P2P. Это идентификаторы для во время обнаружения устройств.

uNumDeviceFilters

Количество фильтров устройств P2P, используемых во время обнаружения устройств WFD. Значение по умолчанию для этого поля — 0.

uIEsOffset

Смещение в InformationBufferструктуры NDIS_OID_REQUEST , с которой начинаются дополнительные информационные элементы (IES).

uIEsLength

Длина (в байтах) дополнительных IES, которые порт устройства Wi-Fi Direct должен добавить в пакет запроса пробы. Если это значение равно 0, система не предоставила никаких IEs, и мини-порт должен вставить 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)