WLAN_RAW_DATA_LIST 구조체(wlanapi.h)

아티클
08/28/2023

WLAN_RAW_DATA_LIST 구조에는 일부 네이티브 Wifi 함수에서 사용되는 데이터 Blob 배열 형식의 원시 데이터가 포함됩니다.

구문

typedef struct _WLAN_RAW_DATA_LIST {
  DWORD                   dwTotalSize;
  DWORD                   dwNumberOfItems;
  struct {
    DWORD dwDataOffset;
    DWORD dwDataSize;
  };
  __unnamed_struct_1943_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 함수에서 애플리케이션에 대한 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 데이터 항목의 최대 수입니다.

IE 형식에 대한 설명을 포함하여 PSD IE에 대한 자세한 내용은 WlanSetPsdIEDataList를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	wlanapi.h(Wlanapi.h 포함)