다음을 통해 공유


OID_WDI_TASK_CONNECT(dot11wificxintf.h)

Important

이 항목은 WiFiCx 드라이버 모델의 일부입니다. WiFiCx는 Windows 11에서 릴리스된 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다. 이전 Wi-Fi 드라이버 모델 WDI는 기본 테넌스 모드이며 높은 우선 순위 수정만 받습니다.

OID_WDI_TASK_CONNECT IHV 구성 요소가 액세스 지점 또는 Wi-Fi Direct GO에 연결하도록 요청합니다.

Object 중단 가능 기본 우선 순위(호스트 드라이버 정책) 일반 실행 시간(초)
포트 예. 중단 뒤에 dot11 재설정이 있어야 합니다. 4 10

연결의 일부로 IHV 구성 요소는 BSS와 동기화, 인증 및 연결해야 합니다. 호스트는 IHV 구성 요소가 연결을 시도할 수 있는 BSS 항목을 제공합니다. IHV 구성 요소가 해당 항목 중 하나에 성공적으로 연결되면 연결 프로세스를 완료해야 합니다. BSS 항목에 연결할 수 없는 경우 실패와 함께 연결 프로세스를 완료해야 합니다.

IHV 구성 요소는 후보 BSS 항목을 찾기 위해 검사를 수행할 필요가 없습니다. 호스트에서 제공하는 목록을 연결에 사용할 수 있습니다. 각각에 연결하려고 할 수 있습니다. 호스트는 RSSI를 기준으로 네트워크를 정렬하지만 IHV 구성 요소는 연결에 고유한 순서를 사용할 수 있습니다. 어댑터에서 "커넥트 BSS 선택 재정의"를 지정하지 않으면 호스트에서 제공하는 항목만 연결에 사용해야 합니다. 호스트가 미해결 연결에서 중단을 발급할 수 있습니다. 중단을 수신할 때 포트는 연결 시도를 종료하고 호스트에 완료를 보고해야 합니다.

어댑터가 "커넥트 BSS 선택 재정의"를 지정하는 경우 자체적으로 검사를 수행하여 후보 BSS 항목을 찾을 수 있습니다. 호스트에서 구성한 매개 변수를 충족하는 한 찾은 모든 BSS 항목에 연결할 수 있습니다. 구성된 연결 품질 요구 사항을 충족하도록 이 선택을 최적화해야 합니다. 여기에는 로밍 검색 최적화, AP 선택 최적화, 연결 프로세스 최적화, 필요한 보안 핸드셰이크 최소화 등이 포함될 수 있습니다. 검색하는 동안 디바이스에 찾은 BSS 항목에 대한 추가 연결 매개 변수(예: 로밍용 PMKID)가 필요한 경우 매개 변수를 가져오는 NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST 표시를 보낼 수 있습니다. 사용 가능한 경우 호스트는 OID_WDI_SET_ASSOCIATION_PARAMETERS 사용하여 이러한 매개 변수를 구성합니다.

연결이 실패하거나 중단된 경우 포트는 connect 명령 외부에서 구성되었을 수 있는 설정을 다시 설정해서는 안 됩니다. 동일한 포트에서 두 번째 연결 호출을 실행하는 호스트를 지원해야 합니다.

각 BSS 항목에 대한 연결 시도의 상태 연결 시도가 끝날 때 포트에서 보고해야 합니다. 여기에는 성공적인 시도 및 실패한 시도도 포함됩니다. 언제든지 포트를 둘 이상의 액세스 지점 또는 Wi-Fi Direct GO와 연결해야 합니다.

연결이 진행되는 동안 포트는 기본 다른 포트에 설정된 모든 연결(예: 인프라 또는 Wi-Fi Direct)을 확인해야 합니다. 그러나 포트는 연결을 완료하기 위해 다른 포트에 제공된 중간 액세스의 양을 줄일 수 있습니다. 연결하는 동안 호스트는 다른 포트에서 패킷 보내기 요청을 제출할 수 있습니다.

연결에 사용되는 인증 알고리즘에 네트워크 액세스를 위한 802.1x 포트 권한 부여가 필요한 경우 연결 작업이 성공적으로 완료된 후 호스트가 포트에 권한을 부여합니다.

802.11 스테이션은 사전 인증에 PMKID 캐시를 사용하여 RSNA(강력한 보안 네트워크 연결) 인증 알고리즘을 사용하도록 설정한 지점에 액세스합니다. 802.11 스테이션이 제공된 PMKID가 있는 BSSID와 연결되거나 다시 연결되는 경우 802.11 스테이션은 연결 또는 연결 프레임의 RSN IE(RSN 정보 요소)에서 PMKID 데이터를 사용해야 합니다.

포트가 WIFI_STATION_CAPABILITIES 호스트 FIPS 모드에 대한 지원을 선언하는 경우 연결 매개 변수에서 HostFIPSModeEnabled를 1설정할 수 있습니다.

HostFIPSModeEnabled가 1설정된 경우 다음 규칙이 적용됩니다.

  • 포트는 FIPS 모드의 송신 작업 및 FIPS 모드의 수신 작업에서 데이터 프레임을 보내거나 받기 위한 지침을 따라야 합니다.
  • 포트는 HT가 아닌 액세스 지점으로 전송된 연결 요청에서 QoS 프로토콜에 대한 지원을 선언해서는 안 됩니다. HT 연결에는 QoS 지원이 필요합니다.
  • 포트는 TSpec을 협상해서는 안 되며 전송 MSDU 집계를 수행해서는 안 됩니다.
  • 포트는 전송하는 RSN 기능 IE의 SPP A-MSDU 지원 비트(비트 10)가 0으로 설정되어 있는지 확인해야 합니다. 이 모드에서는 PP A-MSDU만 지원됩니다.

연결 매개 변수에는 MFPEnabledHostFIPSModeEnabled가 모두 1설정되어 있지 않아야 합니다. 관리 프레임 보호(802.11w)를 사용하려면 포트가 특정 관리 및 작업 프레임을 암호화/암호 해독해야 하므로 호스트 FIPS 모드를 사용하여 연결을 사용하도록 설정할 수 없습니다. 또한 Wake on Wireless LAN 기능은 호스트-FIPS 모드에서 적용할 수 없습니다.

WiFi 7/MLO 요구 사항

Windows는 드라이버가 MLO를 사용하여 연결할 수 있는지 여부를 나타내는 WDI_TLV_CONNECTION_SETTINGS Mlo커넥트ionSupported 설정을 제공합니다. 보안 네트워크에 연결할 때 드라이버는 WDI_TLV_RSNA_AKM_CIPHER_SUITE 지정된 AKM 및 암호 쌍만 사용할 수 있습니다. 유일한 예외는 인증/암호가 RSNA IE의 일부가 아닌 경우입니다.

자세한 내용은 WiFiCx Wi-Fi 7 기능 요구 사항을 참조 하세요.

작업 매개 변수

TLV 여러 TLV 인스턴스 허용 선택 사항 설명
WDI_TLV_CONNECT_PARAMETERS 연결 매개 변수입니다.
WDI_TLV_CONNECT_BSS_ENTRY X 후보 연결 BSS 항목의 기본 설정 목록입니다. 포트는 목록이 소진되거나 연결이 성공적으로 완료될 때까지 이러한 BSS 항목 중 하나라도 연결을 시도해야 합니다. 필요한 경우 포트에서 항목의 우선 순위를 다시 지정할 수 있습니다. 어댑터가 커넥트 BSS 선택 재정의 비트를 설정한 경우 허용/허용되지 않는 목록을 따르는 한 이 목록에 없는 BSS를 선택할 수 있습니다.

작업 완료 표시

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

원치 않는 표시

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 11
지원되는 최소 서버 Windows Server 2022
헤더 dot11wificxintf.h