struttura WLAN_RAW_DATA_LIST (wlanapi.h)
La struttura WLAN_RAW_DATA_LIST contiene dati non elaborati sotto forma di matrice di BLOB di dati usati da alcune funzioni Native Wifi.
Sintassi
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;
Members
dwTotalSize
Dimensione totale, in byte, della struttura WLAN_RAW_DATA_LIST .
dwNumberOfItems
Numero di voci o BLOB di dati non elaborati nella struttura WLAN_RAW_DATA_LIST . Il valore massimo di dwNumberOfItems può essere limitato dal tipo di dati archiviati nella struttura WLAN_RAW_DATA_LIST .
dwDataOffset
dwDataSize
DataList[1]
Matrice di voci o BLOB di dati non elaborati che costituiscono l'elenco di dati.
dwDataOffset
Offset, in byte, del BLOB di dati dall'inizio del descrittore BLOB corrente. Per informazioni dettagliate, vedere l'esempio nella sezione Osservazioni di seguito.
dwDataSize
Dimensione, in byte, del BLOB di dati.
Commenti
La struttura WLAN_RAW_DATA_LIST viene usata per incapsulare un elenco di BLOB di dati in un blocco di memoria flat. Deve essere interpretato come un elenco di intestazioni seguito da BLOB di dati.
Per creare un WLAN_RAW_DATA_LIST, un'applicazione deve allocare un blocco di memoria sufficientemente grande da contenere le intestazioni e i BLOB di dati e quindi eseguire il cast del blocco di memoria a un puntatore a una struttura WLAN_RAW_DATA_LIST .
Di seguito è riportato il layout di memoria di un esempio WLAN_RAW_DATA_LIST struttura che contiene due BLOB di dati.
| Offset di memoria | Campo | valore | Commenti |
| 0 | dwTotalSize | 84 | |
| 4 | dwNumberOfItems | 2 | |
| 8 | dwDataOffset | 16 | Offset del primo BLOB: 16 = 24 - 8 |
| 12 | dwDataSize | 20 | Dimensioni del primo BLOB. |
| 16 | dwDataOffset | 28 | Offset del secondo BLOB: 44 - 16. |
| 20 | dwDataSize | 24 | Dimensioni del secondo BLOB. |
| 24 | 20 | Inizio del primo BLOB. | |
| 44 | 40 | Inizio del secondo BLOB. |
La struttura WLAN_RAW_DATA_LIST è attualmente utilizzata dalla funzione WlanSetPsdIEDataList per impostare l'elenco di dati dell'elemento informativo psd (Proximity Service Discovery) per un'applicazione.
Quando viene usato per archiviare un elenco di dati di IE PSD, la costante DOT11_PSD_IE_MAX_ENTRY_NUMBER definita nel file di intestazione Wlanapi.h è il valore massimo del membro dwNumberOfItems per il numero di BLOB nella struttura WLAN_RAW_DATA_LIST . La costante DOT11_PSD_IE_MAX_DATA_SIZE definita nel file di intestazione Wlanapi.h è il valore massimo del membro dwDataSize per qualsiasi BLOB.
| Costante | Valore | Descrizione |
|---|---|---|
| DOT11_PSD_IE_MAX_DATA_SIZE | 240 | Dimensione massima dei dati, in byte, di una voce di dati di IE PSD. |
| DOT11_PSD_IE_MAX_ENTRY_NUMBER | 5 | Numero massimo di voci di dati di IE psd. |
Per altre informazioni sugli IE PSD, inclusa una discussione sul formato di un IE, vedere WlanSetPsdIEDataList.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | wlanapi.h (include Wlanapi.h) |