Partager via


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 utilisés par certaines fonctions Wifi natives.

Syntaxe

typedef struct _WLAN_RAW_DATA_LIST {
  DWORD                   dwTotalSize;
  DWORD                   dwNumberOfItems;
  struct {
    DWORD dwDataOffset;
    DWORD dwDataSize;
  };
  __unnamed_struct_0444_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 à partir du 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. Elle doit être interprétée 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 grand pour contenir les en-têtes et les objets blob de données, puis convertir le bloc de mémoire en pointeur vers une structure WLAN_RAW_DATA_LIST .

Voici la disposition de mémoire d’un exemple de structure WLAN_RAW_DATA_LIST qui contient deux objets blob de données.

Décalage de mémoire Terrain 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 de l’élément d’informations de découverte de services 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.

Constante 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 DSP IE.
 

Pour plus d’informations sur les EE PSD, notamment une discussion sur le format d’un IE, consultez WlanSetPsdIEDataList.

Spécifications

Besoin Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête wlanapi.h (include Wlanapi.h)

Voir aussi

WLAN_RAW_DATA

WlanExtractPsdIEDataList

WlanScan

WlanSetPsdIEDataList