structure WLAN_RAW_DATA_LIST (wlanapi.h)
La structure WLAN_RAW_DATA_LIST contient des données brutes sous la forme d’un tableau d’objets blob de données qui sont utilisés par certaines fonctions Native Wifi.
Syntaxe
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;
Membres
dwTotalSize
Taille totale, en octets, de la structure WLAN_RAW_DATA_LIST .
dwNumberOfItems
Nombre d’entrées de données brutes ou d’objets blob dans la structure WLAN_RAW_DATA_LIST . La valeur maximale de dwNumberOfItems peut être limitée par le type de données stockées dans la structure WLAN_RAW_DATA_LIST .
dwDataOffset
dwDataSize
DataList[1]
Tableau d’entrées de données brutes ou d’objets blob qui composent la liste de données.
dwDataOffset
Décalage, en octets, de l’objet blob de données depuis le début du descripteur d’objet blob actuel. Pour plus d’informations, consultez l’exemple dans la section Remarques ci-dessous.
dwDataSize
Taille, en octets, de l’objet blob de données.
Remarques
La structure WLAN_RAW_DATA_LIST est utilisée pour encapsuler une liste d’objets blob de données dans un bloc de mémoire plate. Il doit être interprété comme une liste d’en-têtes suivis d’objets blob de données.
Pour créer un WLAN_RAW_DATA_LIST, une application doit allouer un bloc de mémoire suffisamment volumineux pour contenir les en-têtes et les objets blob de données, puis convertir le bloc de mémoire en un pointeur vers une structure WLAN_RAW_DATA_LIST .
Voici la disposition en mémoire d’un exemple WLAN_RAW_DATA_LIST structure qui contient deux objets blob de données.
| Décalage de mémoire | Champ | Valeur | Commentaires |
| 0 | dwTotalSize | 84 | |
| 4 | dwNumberOfItems | 2 | |
| 8 | dwDataOffset | 16 | Décalage du premier objet blob : 16 = 24 - 8 |
| 12 | dwDataSize | 20 | Taille du premier objet blob. |
| 16 | dwDataOffset | 28 | Décalage du deuxième objet blob : 44 - 16. |
| 20 | dwDataSize | 24 | Taille du deuxième objet blob. |
| 24 | 20 | Début du premier objet blob. | |
| 44 | 40 | Début du deuxième objet blob. |
La structure WLAN_RAW_DATA_LIST est actuellement utilisée par la fonction WlanSetPsdIEDataList pour définir la liste de données d’éléments d’information de découverte de service de proximité (IE) pour une application.
Lorsqu’elle est utilisée pour stocker une liste de données IE PSD, la constante DOT11_PSD_IE_MAX_ENTRY_NUMBER définie dans le fichier d’en-tête Wlanapi.h est la valeur maximale du membre dwNumberOfItems pour le nombre d’objets blob dans la structure WLAN_RAW_DATA_LIST . La constante DOT11_PSD_IE_MAX_DATA_SIZE définie dans le fichier d’en-tête Wlanapi.h est la valeur maximale du membre dwDataSize pour n’importe quel objet blob.
| Constant | Valeur | Description |
|---|---|---|
| DOT11_PSD_IE_MAX_DATA_SIZE | 240 | Taille maximale des données, en octets, d’une entrée de données PSD IE. |
| DOT11_PSD_IE_MAX_ENTRY_NUMBER | 5 | Nombre maximal d’entrées de données PSD IE. |
Pour plus d’informations sur les EE PSD, y compris une discussion sur le format d’un IE, consultez WlanSetPsdIEDataList.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | wlanapi.h (inclure Wlanapi.h) |