다음을 통해 공유

WLAN_INTF_OPCODE 열거형(wlanapi.h)

  • 아티클

중요

일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

무선 인터페이스에서 매개 변수를 설정하고 쿼리하는 데 사용되는 다양한 opcode를 지정하는 상수를 정의합니다. 이러한 상수는 OpCode 매개 변수를 WlanQueryInterface 및 WlanSetInterface 함수에 전달하여 무선 인터페이스에서 매개 변수를 쿼리하거나 설정할 수 있는 가능한 opcode를 나타냅니다.

Syntax

typedef enum _WLAN_INTF_OPCODE {
  wlan_intf_opcode_autoconf_start = 0x000000000,
  wlan_intf_opcode_autoconf_enabled,
  wlan_intf_opcode_background_scan_enabled,
  wlan_intf_opcode_media_streaming_mode,
  wlan_intf_opcode_radio_state,
  wlan_intf_opcode_bss_type,
  wlan_intf_opcode_interface_state,
  wlan_intf_opcode_current_connection,
  wlan_intf_opcode_channel_number,
  wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs,
  wlan_intf_opcode_supported_adhoc_auth_cipher_pairs,
  wlan_intf_opcode_supported_country_or_region_string_list,
  wlan_intf_opcode_current_operation_mode,
  wlan_intf_opcode_supported_safe_mode,
  wlan_intf_opcode_certified_safe_mode,
  wlan_intf_opcode_hosted_network_capable,
  wlan_intf_opcode_management_frame_protection_capable,
  wlan_intf_opcode_secondary_sta_interfaces,
  wlan_intf_opcode_secondary_sta_synchronized_connections,
  wlan_intf_opcode_realtime_connection_quality,
  wlan_intf_opcode_qos_info,
  wlan_intf_opcode_autoconf_end = 0x0fffffff,
  wlan_intf_opcode_msm_start = 0x10000100,
  wlan_intf_opcode_statistics,
  wlan_intf_opcode_rssi,
  wlan_intf_opcode_msm_end = 0x1fffffff,
  wlan_intf_opcode_security_start = 0x20010000,
  wlan_intf_opcode_security_end = 0x2fffffff,
  wlan_intf_opcode_ihv_start = 0x30000000,
  wlan_intf_opcode_ihv_end = 0x3fffffff
} WLAN_INTF_OPCODE, *PWLAN_INTF_OPCODE;

상수

 
wlan_intf_opcode_autoconf_start
값: 0x000000000
사용되지 않습니다.
wlan_intf_opcode_autoconf_enabled
자동 구성이 사용되는지 여부를 설정하거나 쿼리하는 데 사용되는 opcode입니다.
wlan_intf_opcode_background_scan_enabled
백그라운드 검사를 사용할 수 있는지 여부를 설정하거나 쿼리하는 데 사용되는 opcode입니다.

백그라운드 검사는 인터페이스가 연결된 상태인 경우에만 사용하지 않도록 설정할 수 있습니다. 하나 이상의 클라이언트가 사용하지 않도록 설정하면 백그라운드 검사를 사용할 수 없습니다.
인터페이스의 연결이 끊어지면 백그라운드 검사가 자동으로 사용하도록 설정됩니다.
wlan_intf_opcode_media_streaming_mode
드라이버의 미디어 스트리밍 모드를 설정하거나 쿼리하는 데 사용되는 opcode입니다.

미디어 스트리밍 모드는 인터페이스가 연결된 상태일 때만 설정할 수 있습니다. 하나 이상의 클라이언트가 사용하도록 설정하면 미디어 스트리밍 모드가 활성화됩니다. 인터페이스의 연결이 끊어지면 미디어 스트리밍 모드가 자동으로 비활성화됩니다.
wlan_intf_opcode_radio_state
라디오 상태를 설정하거나 쿼리하는 데 사용되는 opcode입니다.
wlan_intf_opcode_bss_type
인터페이스의 BSS 형식을 설정하거나 쿼리하는 데 사용되는 opcode입니다.
wlan_intf_opcode_interface_state
인터페이스의 상태를 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_current_connection
인터페이스의 현재 연결에 대한 정보를 쿼리하는 데 사용되는 opcode입니다.

이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다. 인터페이스의 연결이 끊어지거나 연결이 끊긴 상태인 경우 WlanQueryInterface 함수는 ERROR_INVALID_STATE 반환합니다.
wlan_intf_opcode_channel_number
무선 인터페이스가 작동하는 현재 채널을 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
인프라 모드에 대해 지원되는 인증/암호 쌍을 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
임시 모드에 대해 지원되는 인증/암호 쌍을 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_supported_country_or_region_string_list
지원되는 국가 또는 지역 문자열 목록을 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_current_operation_mode
무선 인터페이스의 현재 작업 모드를 설정하거나 쿼리하는 데 사용되는 opcode입니다. 작업 모드에 대한 자세한 내용은 네이티브 802.11 작업 모드를 참조하세요.
wlan_intf_opcode_supported_safe_mode
미니포트/NIC 조합이 FIPS(Federal Information Processing Standards) 모드를 지원하는지 여부를 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다. FIPS 모드를 안전 모드라고도 합니다. 이 무선 안전 모드는 운영 체제 안전 모드와 다릅니다.
wlan_intf_opcode_certified_safe_mode
미니포트/NIC 조합이 FIPS 인증 여부를 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_hosted_network_capable
무선 인터페이스와 연결된 디바이스 드라이버에서 Hosted Network 지원을 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.

쿼리에서 이 opcode에 대해 반환된 데이터 형식은 부울입니다. TRUE 값이 반환되면 Hosted Network가 지원됨을 나타냅니다. FALSE 값은 Hosted Network가 지원되지 않음을 나타냅니다.

이 값은 무선 LAN 서비스가 설치된 Windows 7 및 Windows Server 2008 R2에서 무선 호스트 네트워크를 지원하기 위해 추가된 네이티브 무선 API에 대한 확장입니다.
wlan_intf_opcode_management_frame_protection_capable
MFP(관리 프레임 보호)가 무선 인터페이스와 연결된 디바이스 드라이버에서 지원되는지 여부를 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.

MFP는 IEEE 802.11w-2009 수정 버전에서 802.11 표준으로 정의됩니다.

이 값은 Windows 8 및 Windows Server 2012 지원됩니다.
wlan_intf_opcode_secondary_sta_interfaces
클라이언트가 지정된 인터페이스의 보조 STA에 대한 정보를 쿼리할 수 있습니다. 지정된 인터페이스에서 보조 STA의 WLAN_INTERFACE_INFO_LIST 반환합니다.
wlan_intf_opcode_secondary_sta_synchronized_connections
지정된 인터페이스에서 보조 STA 동기화 연결을 사용할 수 있는지 여부를 쿼리하는 데 사용되는 Opcode입니다.
wlan_intf_opcode_realtime_connection_quality
클라이언트가 지정된 인터페이스에서 연결의 품질을 설명하는 특성을 쿼리할 수 있도록 하는 opcode입니다. 이 API는 다양한 기존 WLAN API(wlan_intf_opcode_current_connection 및 WlanGetNetworkBssList)의 필드를 결합하지만 위치 구분 정보를 생략하므로 위치 액세스 권한이 필요하지 않습니다.

이 opcode는 지정된 인터페이스에서 연결의 품질을 설명하는 특성이 포함된 구조를 검색합니다. 인터페이스가 연결되지 않은 경우 실패합니다. 앱은 이 API를 사용하여 WiFi 연결의 상태 및 품질에 대한 정보를 가져올 수 있습니다(API에는 스트리밍, 비디오 회의 및 기타 네트워크 품질에 민감한 작업에 대한 애플리케이션이 있습니다.) 현재 wlan_intf_opcode_current_connection 및 WlanGetNetworkBssList 를 사용하여 연결 품질 정보를 검색하지만 위치 액세스를 요청하지 않는 앱은 이 API를 사용할 수 있습니다.

자세한 내용은 WLAN_REALTIME_CONNECTION_QUALITY 코드 예제를 참조하세요.
wlan_intf_opcode_qos_info
클라이언트가 Wi-Fi Alliance의 Wi-Fi QoS 관리 사양에 설명되고 802.11 사양에 정의된 QoS(서비스 품질) 기능의 상태를 쿼리할 수 있도록 하는 opcode입니다.

이 opcode는 WFA의 Wi-Fi QoS 관리 사양에 설명되고 802.11 사양에 정의된 네 가지 기능에 대한 정보를 포함하는 구조를 검색합니다. 앱은 이 API를 사용하여 디바이스의 WFA QoS 기능에 대한 정보를 가져올 수 있으며, 연결된 경우 피어의 WFA QoS 기능과 현재 연결에 대해 구성된 WFA QoS 기능의 상태를 가져올 수 있습니다. 현재 QoS2 또는 다른 QoS API를 사용하는 앱은 이를 사용하여 성능 원격 분석 또는 UI 표시를 위해 추가 QoS 정보를 가져올 수 있습니다. 이 API를 사용하여 동작 변경 내용을 알리는 것은 주요 목적이 아닙니다.

자세한 내용은 WLAN_QOS_INFO 코드 예제를 참조 하세요.
wlan_intf_opcode_autoconf_end
값: 0x0fffffff
사용되지 않습니다.
wlan_intf_opcode_msm_start
값: 0x10000100
사용되지 않습니다.
wlan_intf_opcode_statistics
드라이버 통계를 쿼리하는 데 사용되는 opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_rssi
수신된 신호 강도를 쿼리하는 데 사용되는 Opcode입니다. 이 opcode는 WlanQueryInterface 함수를 사용하는 쿼리 작업에서만 사용할 수 있습니다.
wlan_intf_opcode_msm_end
값: 0x1fffffff
사용되지 않습니다.
wlan_intf_opcode_security_start
값: 0x20010000
사용되지 않습니다.
wlan_intf_opcode_security_end
값: 0x2fffffff
사용되지 않습니다.
wlan_intf_opcode_ihv_start
값: 0x30000000
사용되지 않습니다.
wlan_intf_opcode_ihv_end
값: 0x3fffffff
사용되지 않습니다.

요구 사항

요구 사항 값
헤더 wlanapi.h

추가 정보