Freigeben über


WLAN_RAW_DATA_LIST-Struktur (wlanapi.h)

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_1945_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)

Weitere Informationen

WLAN_RAW_DATA

WlanExtractPsdIEDataList

WlanScan

WlanSetPsdIEDataList