중요하다
WiFiCx Windows 11에서 릴리스된 새로운 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다. WDI 드라이버 모델은 이제 유지 관리 모드에 있으며 높은 우선 순위 수정만 받습니다.
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 포함) |