(wlanapi.h) WLAN_RAW_DATA_LIST 结构

项目
03/04/2024

WLAN_RAW_DATA_LIST 结构包含由某些 Native Wifi 函数使用的数据 Blob 数组形式的原始数据。

语法

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

成员

dwTotalSize

WLAN_RAW_DATA_LIST 结构的总大小（以字节为单位）。

dwNumberOfItems

WLAN_RAW_DATA_LIST 结构中的原始数据条目或 blob 数。 dwNumberOfItems 的最大值可能受存储在 WLAN_RAW_DATA_LIST 结构中的数据的类型的限制。

dwDataOffset

dwDataSize

DataList[1]

构成数据列表的原始数据条目或 Blob 的数组。

dwDataOffset

数据 Blob 从当前 Blob 描述符的开头的偏移量（以字节为单位）。有关详细信息，请参阅下面的“备注”部分中的示例。

dwDataSize

数据 Blob 的大小（以字节为单位）。

注解

WLAN_RAW_DATA_LIST结构用于将数据 Blob 列表封装到平面内存块中。应将其解释为标头列表，后跟数据 Blob。

若要创建 WLAN_RAW_DATA_LIST，应用程序需要分配一个足够大的内存块来保存标头和数据 Blob，然后将内存块强制转换为指向 WLAN_RAW_DATA_LIST 结构的指针。

下面是包含两个数据 blob 的示例 WLAN_RAW_DATA_LIST 结构的内存布局。

内存偏移量	字段	值	注释
0	dwTotalSize	84
4	dwNumberOfItems	2
8	dwDataOffset	16	第一个 blob 的偏移量：16 = 24 - 8
12	dwDataSize	20	第一个 Blob 的大小。
16	dwDataOffset	28	第二个 blob 的偏移量：44 - 16。
20	dwDataSize	24	第二个 Blob 的大小。
24		20	第一个 Blob 的开头。
44		40	第二个 Blob 的开头。

WLAN_RAW_DATA_LIST 结构当前 由 WlanSetPsdIEDataList 函数用于设置邻近服务发现 (PSD) 信息元素 (IE) 数据列表的应用程序。

当用于存储 PSD IE 数据列表时，在 Wlanapi.h 头文件中定义的DOT11_PSD_IE_MAX_ENTRY_NUMBER常量是 dwNumberOfItems 成员WLAN_RAW_DATA_LIST结构中 blob 数的最大值。 在 Wlanapi.h 头文件中定义的DOT11_PSD_IE_MAX_DATA_SIZE常量是任何 blob 的 dwDataSize 成员的最大值。

常数	Value	说明
DOT11_PSD_IE_MAX_DATA_SIZE	240	PSD IE 数据条目的最大数据大小（以字节为单位）。
DOT11_PSD_IE_MAX_ENTRY_NUMBER	5	PSD IE 数据条目的最大数目。

有关 PSD IDE 的详细信息（包括 IE 格式的讨论），请参阅 WlanSetPsdIEDataList。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	wlanapi.h (包括 Wlanapi.h)