다음을 통해 공유

WifiDeviceSetStationCapabilities 함수(wificx.h)

  • 아티클

WifiDeviceSetStationCapabilities 함수는 WiFiCx 디바이스에 대한 스테이션 기능을 설정합니다.

구문

NTSTATUS WifiDeviceSetStationCapabilities(
  WDFDEVICE                       Device,
  const WIFI_STATION_CAPABILITIES *StationCapabilities
);

매개 변수

Device

WdfDeviceCreate에 대한 이전 호출에서 얻은 클라이언트 드라이버의 프레임워크 디바이스 개체에 대한 핸들입니다.

StationCapabilities

클라이언트 드라이버가 할당하고 초기화된 WIFI_STATION_CAPABILITIES 구조체에 대한 포인터입니다.

반환 값

작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

설명

클라이언트 드라이버는 일반적으로 EvtDevicePrepareHardware 내에서 WifiDeviceSetStationCapabilities를 호출합니다. 자세한 내용은 기본(스테이션) 어댑터 만들기 흐름을 참조하세요.

WIFI_STATION_CAPABILITIES_INIT 호출하여 WIFI_STATION_CAPABILITIES 구조를 초기화하고 크기 필드를 채웁니다. 그런 다음 WifiDeviceSetStationCapabilities 를 호출하여 스테이션 기능을 WiFiCx에 보고합니다.

보조 Sta 연결을 유지하는 기능을 나타내려면 드라이버는 WIFI_STATION_CAPABILITIES 구조체의 NumSecondaryStaBandCombinations 및 SecondaryStaBandsCombinations 필드를 0이 아닌 값으로 설정해야 합니다. 값이 0 또는 NULL이면 보조 Sta 기능이 설정되지 않습니다.

Wi-Fi 7에서 MLO 연결에 대한 지원을 나타내려면 드라이버는 WIFI_STATION_CAPABILITIES 구조체의 MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported 및 AkmsList 필드를 0이 아닌 값으로 설정해야 합니다.

GCMP-256 암호화와 함께 AKM 24 또는 AKM 8을 사용하여 SAE 연결을 지원하려면 드라이버는 WIFI_STATION_CAPABILITIES 구조에 다음 인증 암호 쌍을 추가해야 합니다.

  • UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
  • MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }

GCMP-256 암호화와의 OWE 연결을 지원하려면 드라이버는 다음 인증 암호 쌍을 추가해야 합니다.

  • UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 11
지원되는 최소 서버 Windows Server 2022
머리글 wificx.h
IRQL PASSIVE_LEVEL

추가 정보

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

기본(스테이션) 어댑터 만들기 흐름