(wlanapi.h) WLAN_RAW_DATA_LIST 结构
WLAN_RAW_DATA_LIST 结构包含由某些 Native Wifi 函数使用的数据 Blob 数组形式的原始数据。
语法
typedef struct _WLAN_RAW_DATA_LIST {
DWORD dwTotalSize;
DWORD dwNumberOfItems;
struct {
DWORD dwDataOffset;
DWORD dwDataSize;
};
__unnamed_struct_1945_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) |