Compartir a través de


WLAN_INTF_OPCODE enumeración (wlanapi.h)

Importante

Cierta información se relaciona con un producto de versión preliminar que puede modificarse sustancialmente antes de su lanzamiento comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Define constantes que especifican varios códigos de operación usados para establecer y consultar parámetros en una interfaz inalámbrica. Estas constantes representan los posibles códigos de operación que se pueden pasar en el parámetro OpCode a las funciones WlanQueryInterface y WlanSetInterface para consultar o establecer parámetros en una interfaz inalámbrica.

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;

Constantes

 
wlan_intf_opcode_autoconf_start
Valor: 0x000000000
No se usa.
wlan_intf_opcode_autoconf_enabled
Código de operación que se usa para establecer o consultar si la configuración automática está habilitada.
wlan_intf_opcode_background_scan_enabled
Código de operación usado para establecer o consultar si está habilitado el examen en segundo plano.

El examen en segundo plano solo se puede deshabilitar cuando la interfaz está en estado conectado. El examen en segundo plano está deshabilitado si al menos un cliente lo deshabilita.
Si la interfaz se desconecta, el examen en segundo plano se habilitará automáticamente.
wlan_intf_opcode_media_streaming_mode
Código de operación usado para establecer o consultar el modo de streaming multimedia del controlador.

El modo de streaming multimedia solo se puede establecer cuando la interfaz está en estado conectado. El modo de streaming multimedia está habilitado si al menos un cliente lo habilita. Si la interfaz se desconecta, el modo de streaming multimedia se deshabilita automáticamente.
wlan_intf_opcode_radio_state
Código de operación usado para establecer o consultar el estado de radio.
wlan_intf_opcode_bss_type
Código de operación usado para establecer o consultar el tipo BSS de la interfaz.
wlan_intf_opcode_interface_state
Código de operación usado para consultar el estado de la interfaz. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_current_connection
Código de operación usado para consultar información sobre la conexión actual de la interfaz.

Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface . Si la interfaz está en estado desconectado o desconectado, la función WlanQueryInterface devuelve ERROR_INVALID_STATE.
wlan_intf_opcode_channel_number
Código de operación utilizado para consultar el canal actual en el que funciona la interfaz inalámbrica. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
Código de operación usado para consultar los pares de autenticación y cifrado admitidos para el modo de infraestructura. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
Código de operación usado para consultar los pares de autenticación y cifrado admitidos para el modo ad hoc. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_supported_country_or_region_string_list
Código de operación usado para consultar la lista de cadenas de país o región admitidas. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_current_operation_mode
Código de operación utilizado para establecer o consultar el modo de operación actual de la interfaz inalámbrica. Para obtener más información sobre los modos de operación, vea Modos de operación nativos 802.11.
wlan_intf_opcode_supported_safe_mode
Código de operación usado para consultar si la combinación de miniporte/NIC admite el modo Federal Information Processing Standards (FIPS). Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface . El modo FIPS también se conoce como modo seguro. Este modo seguro inalámbrico es diferente del modo seguro del sistema operativo.
wlan_intf_opcode_certified_safe_mode
Código de operación utilizado para consultar si la combinación de minipuerto/NIC está certificada por FIPS. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_hosted_network_capable
Código de operación usado para consultar la compatibilidad con la red hospedada en el controlador de dispositivo asociado a la interfaz inalámbrica. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .

El tipo de datos devuelto para este código de operación por una consulta es un valor booleano. Un valor devuelto de TRUE indica que se admite la red hospedada. Un valor false indica que no se admite la red hospedada.

Este valor es una extensión de las API inalámbricas nativas agregadas para admitir la red inalámbrica hospedada en Windows 7 y en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado.
wlan_intf_opcode_management_frame_protection_capable
Código de operación utilizado para consultar si la protección de fotogramas de administración (MFP) se admite en el controlador de dispositivo asociado a la interfaz inalámbrica. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .

MFP se define en la enmienda IEEE 802.11w-2009 a la norma 802.11.

Este valor se admite en Windows 8 y en Windows Server 2012.
wlan_intf_opcode_secondary_sta_interfaces
Permite a los clientes consultar información sobre el STA secundario de una interfaz determinada. Devuelve una WLAN_INTERFACE_INFO_LIST de stAs secundarias en la interfaz especificada.
wlan_intf_opcode_secondary_sta_synchronized_connections
Opcode usado para consultar si las conexiones de STA secundarias sincronizadas están habilitadas o no en la interfaz especificada.
wlan_intf_opcode_realtime_connection_quality
Código de operación que permite a los clientes consultar atributos que describen la calidad de la conexión en la interfaz especificada. Esta API combina campos de otras API wlan existentes (wlan_intf_opcode_current_connection y WlanGetNetworkBssList), pero omite la información confidencial de la ubicación y, por ese motivo, no requiere privilegios de acceso de ubicación.

Este código de operación recupera una estructura que contiene atributos que describen la calidad de la conexión en la interfaz especificada. Se producirá un error si la interfaz no está conectada. La aplicación puede usar esta API para obtener información sobre el estado y la calidad de su conexión WiFi (la API tiene aplicaciones para streaming, videoconferencia y otras operaciones sensibles a la calidad de la red. Las aplicaciones que actualmente usan wlan_intf_opcode_current_connection y WlanGetNetworkBssList para recuperar información de calidad de conexión, pero no tienen el deseo de solicitar acceso a la ubicación, pueden hacer uso de esta API.

Para obtener más información, consulte el ejemplo de código en WLAN_REALTIME_CONNECTION_QUALITY.
wlan_intf_opcode_qos_info
Código de operación que permite a los clientes consultar el estado de las características de calidad de servicio (QoS) que se describen en la especificación de administración de QoS de Wi-Fi Alliance Wi-Fi y definida en la especificación 802.11.

Este código de operación recupera una estructura que contiene información sobre las cuatro características descritas en la especificación de administración de QoS de WFA Wi-Fi y definida en la especificación 802.11. La aplicación puede usar esta API para obtener información sobre las funcionalidades de QoS de WFA del dispositivo y, si está conectado, las funcionalidades de QoS de WFA de su sistema del mismo nivel y el estado de las características de QoS de WFA configuradas para su conexión actual. Una aplicación que actualmente usa QoS2 u otras API de QoS puede usarla para obtener información adicional de QoS con fines de telemetría de rendimiento o visualización de la interfaz de usuario. El uso de esta API para informar a los cambios de comportamiento no es su propósito principal.

Para obtener más información, consulta el ejemplo de código en WLAN_QOS_INFO.
wlan_intf_opcode_autoconf_end
Valor: 0x0fffffff
No se usa.
wlan_intf_opcode_msm_start
Valor: 0x10000100
No se usa.
wlan_intf_opcode_statistics
Código de operación utilizado para consultar las estadísticas del controlador. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_rssi
Código de operación usado para consultar la intensidad de la señal recibida. Este código de operación solo se puede usar en una operación de consulta con la función WlanQueryInterface .
wlan_intf_opcode_msm_end
Valor: 0x1fffffff
No se usa.
wlan_intf_opcode_security_start
Valor: 0x20010000
No se usa.
wlan_intf_opcode_security_end
Valor: 0x2fffffff
No se usa.
wlan_intf_opcode_ihv_start
Valor: 0x30000000
No se usa.
wlan_intf_opcode_ihv_end
Valor: 0x3fffffff
No se usa.

Requisitos

Requisito Valor
Header wlanapi.h

Consulte también