WLAN_RAW_DATA_LIST-Struktur (wlanapi.h)

Artikel
08/28/2023

Die WLAN_RAW_DATA_LIST-Struktur enthält Rohdaten in Form eines Arrays von Datenblobs, die von einigen nativen Wlan-Funktionen verwendet werden.

Syntax

typedef struct _WLAN_RAW_DATA_LIST {
  DWORD                   dwTotalSize;
  DWORD                   dwNumberOfItems;
  struct {
    DWORD dwDataOffset;
    DWORD dwDataSize;
  };
  __unnamed_struct_1943_1 DataList[1];
} WLAN_RAW_DATA_LIST, *PWLAN_RAW_DATA_LIST;

Member

dwTotalSize

Die Gesamtgröße der WLAN_RAW_DATA_LIST Struktur in Bytes.

dwNumberOfItems

Die Anzahl der Rohdateneinträge oder Blobs in der WLAN_RAW_DATA_LIST-Struktur . Der maximale Wert von dwNumberOfItems kann durch den Datentyp eingeschränkt werden, der in der WLAN_RAW_DATA_LIST-Struktur gespeichert ist.

dwDataOffset

dwDataSize

DataList[1]

Ein Array von Rohdateneinträgen oder Blobs, aus denen die Datenliste besteht.

dwDataOffset

Der Offset des Datenblobs in Bytes vom Anfang des aktuellen Blobdeskriptors. Ausführliche Informationen finden Sie im Beispiel im Abschnitt Hinweise unten.

dwDataSize

Die Größe des Datenblobs in Bytes.

Hinweise

Die WLAN_RAW_DATA_LIST-Struktur wird verwendet, um eine Liste von Datenblobs in einen flachen Speicherblock zu kapseln. Es sollte als Liste von Headern gefolgt von Datenblobs interpretiert werden.

Um eine WLAN_RAW_DATA_LIST zu erstellen, muss eine Anwendung einen Arbeitsspeicherblock zuweisen, der groß genug ist, um die Header und die Datenblobs aufzunehmen, und dann den Speicherblock in einen Zeiger auf eine WLAN_RAW_DATA_LIST-Struktur umwandeln.

Im Folgenden finden Sie das Speicherlayout eines Beispiels WLAN_RAW_DATA_LIST Struktur, die zwei Datenblobs enthält.

Speicheroffset	Feld	Wert	Kommentare
0	dwTotalSize	84
4	dwNumberOfItems	2
8	dwDataOffset	16	Offset des ersten Blobs: 16 = 24 - 8
12	dwDataSize	20	Größe des ersten Blobs.
16	dwDataOffset	28	Offset des zweiten Blobs: 44 - 16.
20	dwDataSize	24	Größe des zweiten Blobs.
24		20	Start des ersten Blobs.
44		40	Start des zweiten Blobs.

Die WLAN_RAW_DATA_LIST-Struktur wird derzeit von der WlanSetPsdIEDataList-Funktion verwendet, um die PsD-Datenliste (Proximity Service Discovery, Information Element Information Element, IE) für eine Anwendung festzulegen.

Wenn sie zum Speichern einer PSD IE-Datenliste verwendet wird, ist die in der Headerdatei "Wlanapi.h" definierte DOT11_PSD_IE_MAX_ENTRY_NUMBER Konstante der Maximalwert des dwNumberOfItems-Members für die Anzahl der Blobs in der WLAN_RAW_DATA_LIST-Struktur. Die in der Headerdatei "Wlanapi.h " definierte DOT11_PSD_IE_MAX_DATA_SIZE-Konstante ist der maximale Wert des dwDataSize-Elements für ein Blob.

Konstante	Wert	BESCHREIBUNG
DOT11_PSD_IE_MAX_DATA_SIZE	240	Die maximale Datengröße eines PSD IE-Dateneintrags in Bytes.
DOT11_PSD_IE_MAX_ENTRY_NUMBER	5	Die maximale Anzahl von PSD IE-Dateneinträgen.

Weitere Informationen zu PSD-IEs, einschließlich einer Diskussion über das Format eines IE, finden Sie unter WlanSetPsdIEDataList.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	wlanapi.h (einschließlich Wlanapi.h)