структура WLAN_RAW_DATA_LIST (wlanapi.h)

Статья
03/04/2024

Структура WLAN_RAW_DATA_LIST содержит необработанные данные в виде массива больших двоичных объектов данных, которые используются некоторыми собственными функциями Wi-Fi.

Синтаксис

typedef struct _WLAN_RAW_DATA_LIST {
  DWORD                   dwTotalSize;
  DWORD                   dwNumberOfItems;
  struct {
    DWORD dwDataOffset;
    DWORD dwDataSize;
  };
  __unnamed_struct_196c_1 DataList[1];
} WLAN_RAW_DATA_LIST, *PWLAN_RAW_DATA_LIST;

Члены

dwTotalSize

Общий размер структуры WLAN_RAW_DATA_LIST в байтах.

dwNumberOfItems

Количество необработанных записей данных или BLOB-объектов в структуре WLAN_RAW_DATA_LIST . Максимальное значение dwNumberOfItems может быть ограничено типом данных, которые хранятся в структуре WLAN_RAW_DATA_LIST .

dwDataOffset

dwDataSize

DataList[1]

Массив необработанных записей данных или больших двоичных объектов, составляющих список данных.

dwDataOffset

Смещение большого двоичного объекта данных (в байтах) от начала текущего дескриптора BLOB-объекта. Дополнительные сведения см. в примере в разделе "Примечания" ниже.

dwDataSize

Размер большого двоичного объекта данных (в байтах).

Структура WLAN_RAW_DATA_LIST используется для инкапсуляции списка больших двоичных объектов данных в плоский блок памяти. Его следует интерпретировать как список заголовков, за которыми следуют большие двоичные объекты данных.

Чтобы создать WLAN_RAW_DATA_LIST, приложению необходимо выделить блок памяти, достаточно большой для хранения заголовков и больших двоичных объектов данных, а затем привести блок памяти к указателю на структуру WLAN_RAW_DATA_LIST .

Ниже приведен макет памяти примера WLAN_RAW_DATA_LIST структуры, содержащей два больших двоичных объекта данных.

Смещение памяти	Поле	Значение	Комментарии
0	dwTotalSize	84
4	dwNumberOfItems	2
8	dwDataOffset	16	Смещение первого большого двоичного объекта: 16 = 24 – 8
12	dwDataSize	20	Размер первого большого двоичного объекта.
16	dwDataOffset	28	Смещение второго большого двоичного объекта: 44–16.
20	dwDataSize	24	Размер второго большого двоичного объекта.
24		20	Начало первого большого двоичного объекта.
44		40	Начало второго большого двоичного объекта.

Структура WLAN_RAW_DATA_LIST в настоящее время используется функцией WlanSetPsdIEDataList для задания списка данных элемента обнаружения близкого взаимодействия (PSD) для приложения.

При использовании для хранения списка данных PSD IE константа DOT11_PSD_IE_MAX_ENTRY_NUMBER , определенная в файле заголовка Wlanapi.h , является максимальным значением члена dwNumberOfItems для количества BLOB-объектов в структуре WLAN_RAW_DATA_LIST . Константа DOT11_PSD_IE_MAX_DATA_SIZE , определенная в файле заголовка Wlanapi.h , является максимальным значением члена dwDataSize для любого большого двоичного объекта.

Константа	Значение	Описание
DOT11_PSD_IE_MAX_DATA_SIZE	240	Максимальный размер данных (в байтах) записи данных PSD IE.
DOT11_PSD_IE_MAX_ENTRY_NUMBER	5	Максимальное количество записей данных PSD IE.

Дополнительные сведения о PSD IEs, включая обсуждение формата IE, см. в разделе WlanSetPsdIEDataList.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	wlanapi.h (включая Wlanapi.h)

См. также раздел

WLAN_RAW_DATA

WlanExtractPsdIEDataList

WlanScan

WlanSetPsdIEDataList

Поделиться через