DOT11_BYTE_ARRAY 구조체(windot11.h)

아티클
08/08/2023

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

DOT11_BYTE_ARRAY 구조체는 MiniportOidRequest 함수의 OidRequest 매개 변수의 InformationBuffer 멤버에 있는 가변 길이 구조 목록 앞에 섰습니다.

구문

typedef struct DOT11_BYTE_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfBytes;
  ULONG              uTotalNumOfBytes;
  UCHAR              ucBuffer[1];
} DOT11_BYTE_ARRAY, *PDOT11_BYTE_ARRAY;

멤버

Header

DOT11_BYTE_ARRAY 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.

형식

이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.

수정 버전

이 멤버는 DOT11_BYTE_ARRAY 구조체 뒤에 오는 가변 길이 구조체의 수정 버전으로 설정해야 합니다. 이러한 구조체의 수정 버전에 대한 자세한 내용은 "참고 항목" 섹션에 나열된 OIDS(개체 식별자)를 참조하세요.

크기

이 멤버는 sizeof(DOT11_BYTE_ARRAY)로 설정해야 합니다.

이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER 참조하세요.

uNumOfBytes

ucBuffer 배열의 바이트 수입니다.

uTotalNumOfBytes

ucBuffer 배열에 필요한 최대 바이트 수입니다.

ucBuffer[1]

가변 길이 구조 목록입니다.

설명

ucBuffer 배열에 저장된 구조체의 형식은 OID 집합 및 쿼리 요청에 따라 달라집니다. 예를 들어 OID_DOT11_ENUM_BSS_LIST 쿼리할 때 미니포트 드라이버는 ucBuffer 배열에 하나 이상의 DOT11_BSS_ENTRY 구조를 저장합니다.

DOT11_BYTE_ARRAY 구조를 사용하는 OID에서 쿼리하는 경우 미니포트 드라이버는 MiniportOidRequest 함수의 OidRequest 매개 변수의 InformationBuffer 멤버가 ucBuffer 배열의 모든 항목을 포함하여 전체 구조를 반환할 만큼 충분히 큰지 확인해야 합니다. OidRequest 매개 변수의 InformationBufferLength 멤버 값은 다음 목록에서 보여 주듯이 미니포트 드라이버가 수행해야 하는 작업을 결정합니다.

InformationBufferLength 멤버의 값이 전체 DOT11_BYTE_ARRAY 구조체의 길이(바이트)보다 작은 경우 미니포트 드라이버는 다음을 수행해야 합니다.
- OidRequest 매개 변수의 경우 BytesWritten 멤버를 0으로 설정하고 BytesNeeded 멤버를 전체 DOT11_BYTE_ARRAY 구조체의 길이(바이트)로 설정합니다.
- MiniportOidRequest 함수에서 NDIS_STATUS_BUFFER_OVERFLOW 반환하여 쿼리 요청에 실패합니다.
InformationBufferLength 멤버의 값이 전체 DOT11_BYTE_ARRAY 구조체의 길이(바이트)보다 크거나 같은 경우 미니포트 드라이버는 다음을 수행하여 성공적인 쿼리 요청을 완료해야 합니다.
- DOT11_BYTE_ARRAY 구조체의 경우 uNumOfBytes 및 uTotalNumOfBytes 멤버를 ucBuffer 배열의 총 항목 수로 설정합니다.
- OidRequest 매개 변수의 경우 BytesNeeded 멤버를 0으로 설정하고 BytesWritten 멤버를 전체 DOT11_BYTE_ARRAY 구조체의 길이(바이트)로 설정합니다. 또한 미니포트 드라이버는 전체 DOT11_BYTE_ARRAY 구조를 InformationBuffer 멤버에 복사해야 합니다.
- MiniportOidRequest 함수에서 NDIS_STATUS_SUCCESS 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	windot11.h(Ndis.h 포함)