EN
이 콘텐츠는 한국어로 제공되지 않아 영어 버전으로 표시됩니다.

WLAN_RAW_DATA_LIST structure

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;
  } 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.

DataList

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.

Memory OffsetFieldValueComments
0dwTotalSize84
4dwNumberOfItems 2
8dwDataOffset16Offset of the first blob: 16 = 24 - 8
12dwDataSize20Size of the first blob.
16dwDataOffset28Offset of the second blob: 44 - 16.
20dwDataSize24Size of the second blob.
2420Start of the first blob.
4440Start of the second blob.

 

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.

ConstantValueDescription
DOT11_PSD_IE_MAX_DATA_SIZE240The maximum data size, in bytes, of a PSD IE data entry.
DOT11_PSD_IE_MAX_ENTRY_NUMBER5The maximum number of PSD IE data entries.

 

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

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wlanapi.h (include Wlanapi.h)

See also

WLAN_RAW_DATA
WlanSetPsdIEDataList
WlanExtractPsdIEDataList
WlanScan

 

 

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft