WLAN_RAW_DATA_LIST結構 (wlanapi.h)
WLAN_RAW_DATA_LIST 結構包含原始數據,格式為某些 Native Wifi 函式所使用的數據 Blob 陣列。
語法
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;
成員
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) |