OID_WDI_TASK_SCAN(dot11wificxintf.h)

중요

이 항목은 WiFiCx 드라이버 모델의 일부입니다. WiFiCx는 Windows 11 출시된 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다. 이전 Wi-Fi 드라이버 모델 WDI 는 유지 관리 모드이며 우선 순위가 높은 수정 사항만 받습니다.

OID_WDI_TASK_SCAN BSS 네트워크에 대한 설문 조사를 요청합니다. 포트는 IEEE 802.11 사양의 요구 사항에 따라 검사를 수행합니다.

Object	중단 가능	기본 우선 순위(호스트 드라이버 정책)	일반 실행 시간(초)
포트	예. 포트는 중단 후 깨끗한 상태여야 합니다.	6(백그라운드 검사) 5(사용자가 시작한 검사)	4

포트가 검사를 시작하고 다른 명령을 받을 준비가 되면 WDI_TLV_STATUS 포함된 태스크 시작 메시지가 표시됩니다.

LiveUpdatesNeeded에서 사용하도록 설정할 때 검사가 시작되면 포트는 검색된 BSS 항목에 대한 증분 업데이트( NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST 원치 않는 표시 사용)를 제공해야 합니다. 이전에 검색되었지만 현재 검사에서 포트에서 찾을 수 없었던 BSS 항목은 포트에서 보고해서는 안 됩니다. 전원 및 성능상의 이유로 포트는 3개 이상의 항목을 발견했거나 3개 미만의 항목을 검색했지만 500밀리초 이상 호스트에 보고하지 않은 경우에만 표시를 제한하고 호스트에 업데이트를 보내야 합니다. 검사가 완료된 후 어댑터가 BSS 항목을 관리하지 않는 경우 검색된 BSS 항목을 기억할 필요가 없습니다. 검사 작업이 완료되면 포트는 운영 체제에 작업 완료 알림을 보내고 호스트에 대한 BSS 항목 보고를 중지해야 합니다. 검사 명령은 레거시(비 Wi-Fi Direct 네트워크)를 찾는 데 사용되며 포트는 프로브 요청에 Wi-Fi Direct ES를 포함하지 않아야 합니다.

어댑터가 BSS 항목을 관리하지 않는 경우 호스트는 한정된 기간 동안 검색에서 포트에서 보고한 BSS 항목을 기억합니다. 캐시된 항목을 시간 초과하고 플러시합니다. 어댑터가 BSS 항목을 관리하는 경우 캐시하고 시간 초과합니다. 호스트는 OID_WDI_SET_FLUSH_BSS_ENTRY 명령을 보내 항목을 명시적으로 플러시할 수 있습니다.

호스트는 BSSID를 사용하여 BSS 항목을 추적합니다. 포트가 동일한 BSSID에 대해 두 개의 BSS 항목을 보고하는 경우 호스트는 다른 항목으로 덮어씁니다.

검사가 진행되는 동안 포트는 기존 연결(예: 인프라 또는 Wi-Fi Direct)을 유지해야 합니다. 연결이 이미 있는 경우 포트는 한 번에 하위 집합과 하위 집합 간에 채널의 하위 집합을 검색하고 다른 연결에 매체에 대한 액세스를 제공해야 합니다. 검색하는 동안 호스트는 어댑터의 모든 포트에 패킷 보내기 요청을 제출할 수 있습니다.

표시된 BSS 항목에서 포트는 디바이스 관련 컨텍스트 정보를 포함할 수 있습니다. 포트에서 해당 BSS 항목에 연결하라는 메시지가 표시되면 이 컨텍스트 정보가 디바이스로 다시 전달됩니다. 그러나 BSS 항목이 플러시되면 호스트에서 이 컨텍스트를 자동으로 지울 수 있습니다.

검사 명령을 중단할 수 있습니다. 중단 명령을 받으면 포트가 새 BSS 네트워크를 찾는 시도를 중지하고 가능한 한 빨리 검사 작업을 완료해야 합니다. 작업이 완료된 경우(일반적으로 또는 중단으로 인해) 포트가 양호한 상태여야 해당 포트에서 다른 검사를 실행할 수 있습니다.

어댑터는 검사를 수행할 때 규정 제한을 위반해서는 안 됩니다.

작업 매개 변수

TLV	여러 TLV 인스턴스 허용	옵션	Description
WDI_TLV_BSSID		X	검색할 네트워크의 BSSID입니다. 브로드캐스트 MAC 주소인 경우 스테이션은 모든 BSSID를 검색합니다.
WDI_TLV_SSID	X	X	포트에서 검색해야 하는 SSID 목록 목록입니다. 이 목록에는 여러 SSID가 있을 수 있으며 그 중 하나는 와일드카드일 수 있습니다. 채널에서 활성 검색을 수행할 때 포트는 목록의 각 SSID에 대한 프로브 요청을 보내야 합니다. 이 목록이 비어 있으면 포트에서 모든 SSID를 검색해야 합니다.
WDI_TLV_BAND_CHANNEL	X	X	검색할 권장 채널 목록입니다. 어댑터는 최대 검색 시간 요구 사항을 충족하는 한 채널 목록의 하위 집합 또는 상위 집합에서 검사를 수행할 수 있습니다. 이 목록이 비어 있는 경우 포트는 지원되는 모든 채널에서 검색해야 합니다.
WDI_TLV_VENDOR_SPECIFIC_IE		X	포트에서 보낸 프로브 요청에 포함되어야 하는 하나 이상의 ES입니다. 이러한 ES는 수동 검사에 사용되지 않습니다.
WDI_TLV_SCAN_MODE			스캔 모드 매개 변수입니다.
WDI_TLV_SCAN_DWELL_TIME			시간 매개 변수를 유지합니다.
WDI_TLV_6_GHZ_BAND_CHANNEL		X	6GHz 대역에서 검색하는 데 권장되는 채널 목록입니다. 지정된 경우 어댑터는 최대 검색 시간 요구 사항을 충족하는 한 채널 목록의 하위 집합 또는 상위 집합에서 검사를 수행할 수 있습니다.

작업 완료 표시

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

원치 않는 표시

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

이 알림은 디바이스에서 호스트에게 BSS 항목에 대한 업데이트에 대해 알리는 데 사용됩니다. 언제든지 보낼 수 있습니다.

요구 사항

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