DOT11_SUPPORTED_ANTENNA_LIST 구조체(windot11.h)
구문
typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;
멤버
uNumOfEntries
dot11SupportedAntenna 배열의 항목 수입니다. uNumOfEntries 멤버의 값이 0이면 빈 목록이 표시됩니다.
uTotalNumOfEntries
dot11SupportedAntenna 배열에 포함될 수 있는 최대 항목 수입니다.
dot11SupportedAntenna[1]
지원되는 안테나 목록입니다. 이 목록의 각 요소의 형식은 입니다. DOT11_SUPPORTED_ANTENNA 구조체입니다.
설명
미니포트 드라이버는 둘 중 하나에서 쿼리할 때 DOT11_SUPPORTED_ANTENNA_LIST 구조를 반환합니다. OID_DOT11_SUPPORTED_RX_ANTENNA 또는 OID_DOT11_SUPPORTED_TX_ANTENNA.
이러한 OID를 쿼리할 때 미니포트 드라이버는 MiniportOidRequest 함수의 OidRequest 매개 변수의 InformationBuffer 멤버가 dot11SupportedAntenna 배열의 모든 항목을 포함하여 전체 DOT11_SUPPORTED_ANTENNA_LIST 구조를 반환할 만큼 충분히 큰지 확인해야 합니다. OidRequest 매개 변수의 InformationBufferLength 멤버 값은 다음 목록에서 보여 주듯이 미니포트 드라이버가 수행해야 하는 작업을 결정합니다.
-
InformationBufferLength 멤버의 값이 전체 DOT11_SUPPORTED_ANTENNA_LIST 구조체의 길이(바이트)보다 작으면 미니포트 드라이버는 다음을 수행해야 합니다.
- uNumOfEntries 멤버를 0으로 설정합니다.
-
uTotalNumOfEntries 멤버를 dot11SupportedAntenna 배열의 항목 수로 설정합니다.
OidRequest 매개 변수의 경우 BytesWritten 멤버를 0으로 설정하고 BytesNeeded 멤버를 전체 DOT11_PHY_ID_LIST 구조체의 길이(바이트)로 설정합니다.
- MiniportOidRequest 함수에서 NDIS_STATUS_BUFFER_OVERFLOW 반환하여 쿼리 요청에 실패합니다.
-
InformationBufferLength 멤버의 값이 전체 DOT11_SUPPORTED_ANTENNA_LIST 구조체의 길이(바이트)보다 크거나 같은 경우 미니포트 드라이버는 다음을 수행하여 성공적인 쿼리 요청을 완료해야 합니다.
- DOT11_SUPPORTED_ANTENNA_LIST 구조체의 경우 uNumOfEntries 및 uTotalNumOfEntries 멤버를 dot11SupportedAntenna 배열의 총 항목 수로 설정합니다.
- OidRequest 매개 변수의 경우 BytesNeeded 멤버를 0으로 설정하고 BytesWritten 멤버를 전체 DOT11_SUPPORTED_ANTENNA_LIST 구조체의 길이(바이트)로 설정합니다. 또한 미니포트 드라이버는 전체 DOT11_SUPPORTED_ANTENNA_LIST 구조를 InformationBuffer 멤버에 복사해야 합니다.
- MiniportOidRequest 함수에서 NDIS_STATUS_SUCCESS 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 머리글 | windot11.h(Ndis.h 포함) |