DOT11_SCAN_REQUEST_V2 구조체(windot11.h)

아티클
08/08/2023

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

DOT11_SCAN_REQUEST_V2 구조체는 802.11 스테이션에서 수행하는 명시적 검사 작업에 대한 매개 변수를 정의합니다. 스테이션은 OID_DOT11_SCAN_REQUEST OID 집합 요청에 따라 명시적 검사 작업을 수행합니다.

구문

typedef struct _DOT11_SCAN_REQUEST_V2 {
  DOT11_BSS_TYPE    dot11BSSType;
  DOT11_MAC_ADDRESS dot11BSSID;
  DOT11_SCAN_TYPE   dot11ScanType;
  BOOLEAN           bRestrictedScan;
  ULONG             udot11SSIDsOffset;
  ULONG             uNumOfdot11SSIDs;
  BOOLEAN           bUseRequestIE;
  ULONG             uRequestIDsOffset;
  ULONG             uNumOfRequestIDs;
  ULONG             uPhyTypeInfosOffset;
  ULONG             uNumOfPhyTypeInfos;
  ULONG             uIEsOffset;
  ULONG             uIEsLength;
  UCHAR             ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;

멤버

dot11BSSType

802.11 스테이션이 검사하는 기본 서비스 집합(BSS) 네트워크의 유형입니다. 이 멤버의 데이터 형식은 DOT11_BSS_TYPE 열거형입니다.

dot11BSSID

802.11 스테이션이 검사하는 BSS 네트워크의 BSS ID(BSSID)입니다. 이 멤버가 와일드카드 BSSID(0xFFFFFFFFFFFF)로 설정된 경우 스테이션은 모든 BSSID를 검색합니다.

dot11ScanType

802.11 스테이션에서 수행하는 검사 유형입니다. 이 멤버의 데이터 형식은 다음 값을 선언하는 DOT11_SCAN_TYPE 열거형입니다.

dot11_scan_type_active

스테이션은 검색하는 각 채널에서 802.11 프로브 요청 프레임을 전송합니다. 프로브 요청에 대해 802.11 프로브 응답 프레임을 받을 수 있을 만큼 채널에 오래 유지됩니다. 또한 스테이션은 채널에서 전송된 802.11개의 비콘 프레임을 받습니다.

dot11_scan_type_passive

스테이션은 검색하는 각 채널에서 802.11 프로브 요청 프레임을 전송하지 않습니다. 대신 채널에서 전송된 802.11 비콘 또는 프로브 요청 프레임을 받습니다.

dot11_scan_type_auto

스테이션은 활성 또는 수동 검사를 수행하거나 두 스캔 유형의 조합을 사용할 수 있습니다.

dot11ScanType 값에 관계없이 802.11 스테이션은 현재 규정 도메인에서 유효하지 않은 채널에서 검색할 때마다 dot11_scan_type_passive 검사 유형을 수행해야 합니다. 또한 802.11 스테이션은 기본 규제 도메인이 없는 경우 dot11_scan_type_passive 검사 유형을 수행해야 합니다. 규제 도메인에 대한 자세한 내용은 OID_DOT11_CURRENT_REG_DOMAIN 참조하세요.

dot11_scan_type_forced 비트가 dot11ScanType 멤버에 설정된 경우 802.11 스테이션은 지원되는 모든 채널에서 전체 검사를 수행해야 합니다. dot11_scan_type_forced 비트가 설정되지 않은 경우 802.11 스테이션은 전체 검사를 수행하거나 지원되는 채널의 하위 집합에서 부분 검사를 수행할 수 있습니다.

참고dot11_scan_type_forced 비트는 미니포트 드라이버가 ExtSTA(Extensible Station) 모드에서 작동하는 경우에만 지원됩니다. dot11_scan_type_forced 비트는 DOT11_SCAN_TYPE 값을 사용하여 비트 OR를 통해 설정해야 합니다.

bRestrictedScan

이 멤버가 TRUE이면 802.11 스테이션은 BSS 네트워크에 연결하는 데 사용되는 채널 및 PHY 구성으로 제한된 검사를 수행합니다.

다음 중 어느 것이 true인 경우 미니포트 드라이버는 이 멤버를 무시해야 합니다.

미니포트 드라이버는 ExtSTA 모드에서 작동합니다.
802.11 스테이션이 BSS 네트워크에 연결되어 있지 않습니다.

udot11SSIDsOffset

SSID(서비스 집합 식별자) 목록이 시작되는 ucBuffer 배열의 오프셋입니다. SSID 목록의 각 항목은 DOT11_SSID 구조체로 서식이 지정됩니다.

802.11 스테이션은 목록의 각 SSID를 검색합니다. 예를 들어 dot11ScanType 이 dot11_scan_type_active 설정된 경우 802.11 스테이션은 채널에서 스캔하는 동안 목록의 각 SSID에 대해 802.11 프로브 요청을 전송합니다.

uNumOfdot11SSIDs

SSID 목록의 항목 수입니다.

uNumOfdot11SSID가 0이면 미니포트 드라이버는 와일드카드 길이가 0인 SSID 목록을 사용해야 합니다.

bUseRequestIE

이 멤버가 TRUE인 경우 802.11 스테이션은 활성 검사 중에 전송하는 각 프로브 요청 프레임의 802.11d IE(요청 정보 요소) 내에 요청 ID 목록( uRequestIDsOffset 및 uNumOfRequestIDs 멤버를 통해 정의됨)을 포함해야 합니다.

다음 중 한 가지가 true인 경우 미니포트 드라이버는 이 멤버( uRequestIDsOffset 및 uNumOfRequestIDs 멤버와 함께)를 무시해야 합니다.

미니포트 드라이버는 ExtSTA 모드에서 작동합니다.
802.11 dot11MultiDomainCapabilityEnabled MIB(관리 정보 베이스) 개체는 FALSE입니다. dot11MultiDomainCapabilityEnabled MIB 개체에 대한 자세한 내용은 OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
dot11ScanType 멤버가 dot11_scan_type_passive 설정됩니다.

uRequestIDsOffset

요청 ID 목록이 시작되는 ucBuffer 배열의 오프셋입니다. 요청 ID 목록의 각 항목은 UCHAR 데이터 형식으로 형식이 지정됩니다.

uNumOfRequestIDs

요청 ID 목록의 항목 수입니다.

uPhyTypeInfosOffset

PHY 형식 목록이 시작되는 ucBuffer 배열의 오프셋입니다. PHY 형식 목록의 각 항목은 DOT11_PHY_TYPE_INFO 구조체로 형식이 지정됩니다.

802.11 스테이션은 이 목록에서 지정된 각 PHY 유형을 사용하여 BSS 검사를 수행해야 합니다.

bRestrictedScan이 TRUE로 설정된 경우 미니포트 드라이버는 이 멤버(uNumOfPhyTypeInfos 멤버와 함께)를 무시해야 합니다.

uNumOfPhyTypeInfos

PHY 형식 목록의 항목 수입니다.

uNumOfPhyTypeInfos가 0이면 802.11 스테이션은 지원되는 모든 PHY를 사용하여 검사를 수행합니다.

uIEsOffset

ES(가변 길이 정보 요소) 목록이 시작되는 ucBuffer 배열의 오프셋입니다. 802.11 스테이션은 활성 검사 중에 전송되는 각 프로브 요청 프레임의 끝에 ES 목록을 추가해야 합니다.

dot11ScanType이 dot11_scan_type_passive 설정된 경우 미니포트 드라이버는 uIEsLength 멤버와 함께 이 멤버를 무시해야 합니다.

uIEsLength

ES 목록의 길이(바이트)입니다.

ucBuffer[1]

이 구조체의 다른 멤버를 통해 지정된 선택적 데이터를 포함하는 버퍼입니다.

설명

802.11 스테이션은 OID_DOT11_SCAN_REQUEST OID 집합 요청에 따라 명시적 검사 작업을 수행합니다. 스테이션은 set 요청과 함께 DOT11_SCAN_REQUEST_V2 통해 정의된 매개 변수를 사용하여 검사 작업을 수행합니다.

Native 802.11 미니포트 드라이버에서 수행하는 검사 작업에 대한 자세한 내용은 Native 802.11 Scan Operations를 참조하세요.

ExtSTA 작업 모드에 대한 자세한 내용은 확장 가능한 스테이션 작업 모드를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	windot11.h(Ndis.h 포함)

추가 정보

DOT11_PHY_TYPE_INFO

OID_DOT11_SCAN_REQUEST