WLAN_RAW_DATA_LIST 構造体 (wlanapi.h)

[アーティクル]
03/08/2023

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構造体へのポインターにキャストする必要があります。

2 つのデータ 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	2 番目の BLOB のオフセット: 44 から 16。
20	dwDataSize	24	2 番目の BLOB のサイズ。
24		20	最初の BLOB の先頭。
44		40	2 番目の 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 データエントリの最大数。

IE の形式の説明など、PSD IEs の詳細については、「 WlanSetPsdIEDataList」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	wlanapi.h (Wlanapi.h を含む)