WLAN_RAW_DATA_LIST 結構包含原始數據,其格式為一些 Native Wifi 函式所使用的數據 Blob 陣列。
語法
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;
成員
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 的開頭。 |
WLAN_RAW_DATA_LIST結構目前由 WlanSetPsdIEDataList 函式用來設定應用程式的鄰近服務探索 (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 成員最大值。
| 常數 | 價值 | 說明 |
|---|---|---|
| DOT11_PSD_IE_MAX_DATA_SIZE | 240 | PSD IE 數據輸入的數據大小上限,以位元組為單位。 |
| DOT11_PSD_IE_MAX_ENTRY_NUMBER | 5 | PSD IE 數據項的最大數目。 |
如需 PSD IE 的詳細資訊,包括 IE 格式的討論,請參閱 WlanSetPsdIEDataList。
需求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 標題 | wlanapi.h (包括 Wlanapi.h) |