WLAN_RAW_DATA_LIST結構 (wlanapi.h)

發行項
03/13/2024

WLAN_RAW_DATA_LIST 結構包含原始數據，格式為某些 Native Wifi 函式所使用的數據 Blob 陣列。

語法

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

成員

dwTotalSize

WLAN_RAW_DATA_LIST 結構的大小總計，以位元組為單位。

dwNumberOfItems

WLAN_RAW_DATA_LIST 結構中的原始數據項或 Blob 數目。 dwNumberOfItems 的最大值可能會受限於儲存在WLAN_RAW_DATA_LIST結構中的數據類型。

dwDataOffset

dwDataSize

DataList[1]

組成數據清單的原始數據項或 Blob 陣列。

dwDataOffset

目前 Blob 描述元開頭的數據 Blob 位移，以位元組為單位。如需詳細資訊，請參閱下面的一節中的範例。

dwDataSize

數據 Blob 的大小，以位元組為單位。

備註

WLAN_RAW_DATA_LIST結構可用來將數據 Blob 清單封裝到一般記憶體區塊中。它應該解譯為標頭清單，後面接著數據 Blob。

若要建立 WLAN_RAW_DATA_LIST，應用程式必須配置足以保存標頭和數據 Blob 的記憶體區塊，然後將記憶體區塊轉換成 WLAN_RAW_DATA_LIST 結構的指標。

以下是包含兩個數據 Blob 之範例WLAN_RAW_DATA_LIST 結構的記憶體配置。

記憶體位移	欄位	值	註解
0	dwTotalSize	84
4	dwNumberOfItems	2
8	dwDataOffset	16	第一個 Blob 的位移：16 = 24 - 8
12	dwDataSize	20	第一個 Blob 的大小。
16	dwDataOffset	28	第二個 Blob 的位移：44 - 16。
20	dwDataSize	24	第二個 Blob 的大小。
24		20	第一個 Blob 的開頭。
44		40	第二個 Blob 的開頭。

WlanSetPsdIEDataList 函式目前會使用WLAN_RAW_DATA_LIST結構來設定應用程式的鄰近服務探索 (PSD) 資訊元素 (IE) 數據清單。

用來儲存 PSD IE 資料清單時，Wlanapi.h 頭檔中定義的DOT11_PSD_IE_MAX_ENTRY_NUMBER常數是 WLAN_RAW_DATA_LIST 結構中 blob 數目的 dwNumberOfItems 成員最大值。 Wlanapi.h 頭文件中定義的DOT11_PSD_IE_MAX_DATA_SIZE常數是任何 Blob dwDataSize 成員的最大值。

常數	值	Description
DOT11_PSD_IE_MAX_DATA_SIZE	240	PSD IE 數據輸入的數據大小上限，以位元組為單位。
DOT11_PSD_IE_MAX_ENTRY_NUMBER	5	PSD IE 數據項的最大數目。

如需 PSD IDE 的詳細資訊，包括 IE 格式的討論，請參閱 WlanSetPsdIEDataList。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	wlanapi.h (包含 Wlanapi.h)