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 Wifi-Funktionen verwendet werden.

Syntax

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;

Elemente

dwTotalSize

Die Gesamtgröße der WLAN_RAW_DATA_LIST Struktur in Byte.

dwNumberOfItems

Die Anzahl der Rohdateneinträge oder Blobs in der WLAN_RAW_DATA_LIST Struktur. Der Maximalwert der 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 (in Byte) des Datenblobs vom Anfang des aktuellen BLOB-Deskriptors. Ausführliche Informationen finden Sie im Beispiel unten im Abschnitt "Hinweise".

dwDataSize

Die Größe des Datenblobs in Bytes.

Bemerkungen

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

Um eine WLAN_RAW_DATA_LIST zu erstellen, muss eine Anwendung einen Speicherblock zuweisen, der groß genug ist, um die Header und die Datenblobs zu speichern, und anschließend den Speicherblock in einen Zeiger in eine WLAN_RAW_DATA_LIST Struktur umwandeln.

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

Speicherversatz 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 Datenliste für die Näherungsdiensterkennung (Proximity Service Discovery, PSD) für eine Anwendung festzulegen.

Bei Verwendung zum Speichern einer PSD-IE-Datenliste ist die in der Headerdatei "Wlanapi.h " definierte DOT11_PSD_IE_MAX_ENTRY_NUMBER Konstante der Maximalwert des dwNumberOfItems-Elements 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 Maximalwert des dwDataSize-Elements für ein beliebiges Blob.

Konstante Wert BESCHREIBUNG
DOT11_PSD_IE_MAX_DATA_SIZE 240 Die maximale Datengröße in Bytes eines PSD IE-Dateneintrags.
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ützter Client (Mindestversion) Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Kopfzeile wlanapi.h (include Wlanapi.h)

Siehe auch

WLAN_RAW_DATA

WlanExtractPsdIEDataList

WlanScan

WlanSetPsdIEDataList