estructura WLAN_RAW_DATA_LIST (wlanapi.h)
La estructura de WLAN_RAW_DATA_LIST contiene datos sin procesar en forma de una matriz de blobs de datos que usan algunas funciones wifi nativas.
Sintaxis
typedef struct _WLAN_RAW_DATA_LIST {
DWORD dwTotalSize;
DWORD dwNumberOfItems;
struct {
DWORD dwDataOffset;
DWORD dwDataSize;
};
__unnamed_struct_1949_1 DataList[1];
} WLAN_RAW_DATA_LIST, *PWLAN_RAW_DATA_LIST;
Miembros
dwTotalSize
Tamaño total, en bytes, de la estructura WLAN_RAW_DATA_LIST .
dwNumberOfItems
Número de entradas o blobs de datos sin procesar en la estructura de WLAN_RAW_DATA_LIST . El valor máximo de dwNumberOfItems puede estar restringido por el tipo de datos almacenados en la estructura WLAN_RAW_DATA_LIST .
dwDataOffset
dwDataSize
DataList[1]
Matriz de entradas o blobs de datos sin procesar que componen la lista de datos.
dwDataOffset
Desplazamiento, en bytes, del blob de datos desde el principio del descriptor de blob actual. Para obtener más información, vea el ejemplo de la sección Comentarios a continuación.
dwDataSize
Tamaño, en bytes, del blob de datos.
Comentarios
La estructura WLAN_RAW_DATA_LIST se usa para encapsular una lista de blobs de datos en un bloque de memoria plana. Debe interpretarse como una lista de encabezados seguidos de blobs de datos.
Para crear un WLAN_RAW_DATA_LIST, una aplicación debe asignar un bloque de memoria lo suficientemente grande como para contener los encabezados y los blobs de datos y, a continuación, convertir el bloque de memoria en un puntero a una estructura WLAN_RAW_DATA_LIST .
A continuación se muestra el diseño de memoria de un ejemplo WLAN_RAW_DATA_LIST estructura que contiene dos blobs de datos.
| Desplazamiento de memoria | Campo | Valor | Comentarios |
| 0 | dwTotalSize | 84 | |
| 4 | dwNumberOfItems | 2 | |
| 8 | dwDataOffset | 16 | Desplazamiento del primer blob: 16 = 24 - 8 |
| 12 | dwDataSize | 20 | Tamaño del primer blob. |
| 16 | dwDataOffset | 28 | Desplazamiento del segundo blob: 44 a 16. |
| 20 | dwDataSize | 24 | Tamaño del segundo blob. |
| 24 | 20 | Inicio del primer blob. | |
| 44 | 40 | Inicio del segundo blob. |
La función WlanSetPsdIEDataList usa actualmente la estructura WLAN_RAW_DATA_LIST para establecer la lista de datos del elemento de información de detección de servicios de proximidad (PSD) para una aplicación.
Cuando se usa para almacenar una lista de datos de IE de PSD, la constante DOT11_PSD_IE_MAX_ENTRY_NUMBER definida en el archivo de encabezado Wlanapi.h es el valor máximo del miembro dwNumberOfItems para el número de blobs de la estructura WLAN_RAW_DATA_LIST . La constante DOT11_PSD_IE_MAX_DATA_SIZE definida en el archivo de encabezado Wlanapi.h es el valor máximo del miembro dwDataSize para cualquier blob.
| Constante | Valor | Descripción |
|---|---|---|
| DOT11_PSD_IE_MAX_DATA_SIZE | 240 | Tamaño máximo de datos, en bytes, de una entrada de datos de PSD IE. |
| DOT11_PSD_IE_MAX_ENTRY_NUMBER | 5 | Número máximo de entradas de datos de PSD IE. |
Para obtener más información sobre las IE de PSD, incluida una explicación del formato de un IE, consulta WlanSetPsdIEDataList.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | wlanapi.h (incluya Wlanapi.h) |