DOT11_PHY_ID_LIST 구조체(windot11.h)
중요하다
WiFiCx Windows 11에서 릴리스된 새로운 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다. WDI 드라이버 모델은 이제 유지 관리 모드에 있으며 높은 우선 순위 수정만 받습니다.
DOT11_PHY_ID_LIST 구조체는 0개 이상의 PHY 형식 목록을 지정합니다.
통사론
typedef struct DOT11_PHY_ID_LIST {
NDIS_OBJECT_HEADER Header;
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
ULONG dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;
회원
Header
DOT11_PHY_ID_LIST 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.
미니포트 드라이버는 헤더 멤버를 다음 값으로 설정해야 합니다.
형
이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.
개정판
이 멤버는 DOT11_PHY_ID_LIST_REVISION_1 설정해야 합니다.
크기
이 멤버는 sizeof(DOT11_PHY_ID_LIST)로 설정해야 합니다.
이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER참조하세요.
uNumOfEntries
dot11PhyId 배열의 항목 수입니다.
uTotalNumOfEntries
dot11PhyId 배열에 포함될 수 있는 최대 항목 수입니다.
dot11PhyId[1]
PHY ID(식별자) 목록입니다.
발언
dot11PhyId 배열의 PHY ID는 다음 중 하나여야 합니다.
- Native 802.11 Operational msDot11SupportedPhyTypes MIB(관리 정보 베이스) 개체로 정의된 지원되는 PHY 테이블의 인덱스입니다. PHY ID 및 msDot11SupportedPhyTypes MIB 개체에 대한 자세한 내용은 OID_DOT11_SUPPORTED_PHY_TYPES.
- 값이 DOT11_PHY_ID_ANY PHY ID입니다. 이 PHY ID는 와일드카드 PHY ID라고 하며 802.11 스테이션에서 지원되는 PHY를 지정하는 데 사용됩니다. 와일드카드 PHY ID를 사용하는 경우 dot11PhyId 배열의 유일한 항목이어야 합니다.
이러한 OID를 쿼리할 때 미니포트 드라이버는 MiniportOidRequest 함수의 OidRequest 매개 변수의 InformationBuffer 멤버가 dot11PhyId 배열의 모든 항목을 포함하여 전체 DOT11_PHY_ID_LIST 구조를 반환할 만큼 충분히 큰지 확인해야 합니다. OidRequest 매개 변수의 InformationBufferLength 멤버 값은 다음 목록에서와 같이 미니포트 드라이버가 수행해야 하는 작업을 결정합니다.
-
InformationBufferLength 멤버의 값이 전체 DOT11_PHY_ID_LIST 구조체의 길이(바이트)보다 작으면 미니포트 드라이버는 다음을 수행해야 합니다.
- uNumOfEntries 멤버를 0으로 설정합니다.
- uTotalNumOfEntries 멤버를 dot11PhyId 배열의 항목 수로 설정합니다.
- OidRequest 매개 변수의 경우 BytesWritten 멤버를 0으로 설정하고 BytesNeeded 멤버를 전체 DOT11_PHY_ID_LIST 구조체의 길이(바이트)로 설정합니다.
- MiniportOidRequest 함수에서 NDIS_STATUS_BUFFER_OVERFLOW 반환하여 쿼리 요청을 실패합니다.
-
InformationBufferLength 멤버의 값이 전체 DOT11_PHY_ID_LIST 구조체의 길이(바이트)보다 크거나 같은 경우 미니포트 드라이버는 다음을 수행하여 성공적인 쿼리 요청을 완료해야 합니다.
- DOT11_PHY_ID_LIST 구조체의 경우 uNumOfEntries 설정하고 uTotalNumOfEntries 멤버를 dot11PhyId 배열의 총 항목 수로.
- OidRequest 매개 변수의 경우 BytesNeeded 멤버를 0으로 설정하고 BytesWritten 멤버를 전체 DOT11_PHY_ID_LIST 구조체의 길이(바이트)로 설정합니다. 또한 미니포트 드라이버는 전체 DOT11_PHY_ID_LIST 구조를 InformationBuffer 멤버에 복사해야 합니다.
- MiniportOidRequest 함수에서 NDIS_STATUS_SUCCESS 반환합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 헤더 | windot11.h(Ndis.h 포함) |