WLAN_RAW_DATA_LIST structure (wlanapi.h)

The WLAN_RAW_DATA_LIST structure contains raw data in the form of an array of data blobs that are used by some Native Wifi functions.

Syntax

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

Members

dwTotalSize

The total size, in bytes, of the WLAN_RAW_DATA_LIST structure.

dwNumberOfItems

The number of raw data entries or blobs in the WLAN_RAW_DATA_LIST structure. The maximum value of the dwNumberOfItems may be restricted by the type of data that is stored in the WLAN_RAW_DATA_LIST structure.

dwDataOffset

dwDataSize

DataList[1]

An array of raw data entries or blobs that make up the data list.

dwDataOffset

The offset, in bytes, of the data blob from the beginning of current blob descriptor. For details, see the example in the Remarks section below.

dwDataSize

The size, in bytes, of the data blob.

Remarks

The WLAN_RAW_DATA_LIST structure is used to encapsulate a list of data blobs into a flat memory block. It should be interpreted as a list of headers followed by data blobs.

To create a WLAN_RAW_DATA_LIST, an application needs to allocate a memory block that is large enough to hold the headers and the data blobs, and then cast the memory block to a pointer to a WLAN_RAW_DATA_LIST structure.

The following is the memory layout of an example WLAN_RAW_DATA_LIST structure that contains two data blobs.

The WLAN_RAW_DATA_LIST structure is currently used by the WlanSetPsdIEDataList function to set the proximity service discovery (PSD) information element (IE) data list for an application.

When used to store a PSD IE data list, the DOT11_PSD_IE_MAX_ENTRY_NUMBER constant defined in the Wlanapi.h header file is the maximum value of the dwNumberOfItems member for the number of blobs in the WLAN_RAW_DATA_LIST structure. The DOT11_PSD_IE_MAX_DATA_SIZE constant defined in the Wlanapi.h header file is the maximum value of the dwDataSize member for any blob.

For more information about PSD IEs, including a discussion of the format of an IE, see WlanSetPsdIEDataList.

Requirements

See also

WLAN_RAW_DATA

WlanExtractPsdIEDataList

WlanScan

WlanSetPsdIEDataList