Compartilhar via

enumeração WLAN_INTF_OPCODE (wlanapi.h)

  • Artigo

Importante

Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define constantes que especificam vários opcodes usados para definir e consultar parâmetros em uma interface sem fio. Essas constantes representam os possíveis opcodes que você pode passar no parâmetro OpCode para as funções WlanQueryInterface e WlanSetInterface para consultar ou definir parâmetros em uma interface sem fio.

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
Não usado.
wlan_intf_opcode_autoconf_enabled
O opcode usado para definir ou consultar se a configuração automática está habilitada.
wlan_intf_opcode_background_scan_enabled
O opcode usado para definir ou consultar se a verificação em segundo plano está habilitada.

A verificação em segundo plano só pode ser desabilitada quando a interface está no estado conectado. A verificação em segundo plano será desabilitada se pelo menos um cliente a desabilitar.
Se a interface for desconectada, a verificação em segundo plano será habilitada automaticamente.
wlan_intf_opcode_media_streaming_mode
O opcode usado para definir ou consultar o modo de streaming de mídia do driver.

O modo de streaming de mídia só pode ser definido quando a interface está no estado conectado. O modo de streaming de mídia será habilitado se pelo menos um cliente o habilitar. Se a interface for desconectada, o modo de streaming de mídia será desabilitado automaticamente
wlan_intf_opcode_radio_state
O opcode usado para definir ou consultar o estado de rádio.
wlan_intf_opcode_bss_type
O opcode usado para definir ou consultar o tipo BSS da interface.
wlan_intf_opcode_interface_state
O opcode usado para consultar o estado da interface. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_current_connection
O opcode usado para consultar informações sobre a conexão atual da interface.

Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface . Se a interface estiver em estado desconectado ou desconectado, a função WlanQueryInterface retornará ERROR_INVALID_STATE.
wlan_intf_opcode_channel_number
O opcode usado para consultar o canal atual no qual a interface sem fio está operando. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
O opcode usado para consultar os pares de autenticação/criptografia com suporte para o modo de infraestrutura. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
O opcode usado para consultar os pares de autenticação/criptografia com suporte para o modo ad hoc. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_supported_country_or_region_string_list
O opcode usado para consultar a lista de cadeias de caracteres de país ou região com suporte. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_current_operation_mode
O opcode usado para definir ou consultar o modo de operação atual da interface sem fio. Para obter mais informações sobre modos de operação, consulte Modos de operação nativos 802.11.
wlan_intf_opcode_supported_safe_mode
O opcode usado para consultar se a combinação miniport/NIC dá suporte ao modo FIPS (Federal Information Processing Standards). Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface . O modo FIPS também é conhecido como modo de segurança. Esse modo de segurança sem fio é diferente do modo de segurança do sistema operacional.
wlan_intf_opcode_certified_safe_mode
O opcode usado para consultar se a combinação de miniporto/NIC é certificada pelo FIPS. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_hosted_network_capable
O opcode usado para consultar o suporte à Rede Hospedada no driver de dispositivo associado à interface Wireless. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .

O tipo de dados retornado para esse opcode por uma consulta é um booliano. Um valor retornado de TRUE indica que há suporte para a Rede Hospedada. Um valor false indica que a Rede Hospedada não tem suporte.

Esse valor é uma extensão para APIs sem fio nativas adicionadas para dar suporte à Rede Hospedada sem fio no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.
wlan_intf_opcode_management_frame_protection_capable
O opcode usado para consultar se o MFP (Management Frame Protection) tem suporte no driver de dispositivo associado à interface Wireless. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .

O MFP é definido na alteração do IEEE 802.11w-2009 à norma 802.11.

Esse valor é compatível com Windows 8 e em Windows Server 2012.
wlan_intf_opcode_secondary_sta_interfaces
Permite que os clientes consultem informações sobre o STA secundário de uma determinada interface. Retorna uma WLAN_INTERFACE_INFO_LIST de STAs secundárias na interface fornecida.
wlan_intf_opcode_secondary_sta_synchronized_connections
Opcode usado para consultar se as conexões sincronizadas do STA secundário estão habilitadas ou não na interface especificada.
wlan_intf_opcode_realtime_connection_quality
Um opcode que permite aos clientes consultar atributos que descrevem a qualidade da conexão na interface fornecida. Essa API combina campos de várias outras APIs WLAN existentes (wlan_intf_opcode_current_connection e WlanGetNetworkBssList), mas omite informações confidenciais de localização e, por esse motivo, não requer privilégios de acesso à localização.

Esse opcode recupera uma estrutura que contém atributos que descrevem a qualidade da conexão na interface fornecida. Ele falhará se a interface não estiver conectada. Seu aplicativo pode usar essa API para obter informações sobre o estado e a qualidade de sua conexão WiFi (a API tem aplicativos para streaming, videoconferência e outras operações sensíveis à qualidade da rede. Os aplicativos que atualmente usam wlan_intf_opcode_current_connection e WlanGetNetworkBssList para recuperar informações de qualidade da conexão, mas não desejam solicitar acesso à localização, podem usar essa API.

Para obter mais informações, consulte o exemplo de código em WLAN_REALTIME_CONNECTION_QUALITY.
wlan_intf_opcode_qos_info
Um opcode que permite que os clientes consultem o estado dos recursos de QoS (qualidade de serviço) descritos pela Especificação de Gerenciamento de QoS Wi-Fi da Wi-Fi Alliance e definidos na especificação 802.11.

Esse opcode recupera uma estrutura que contém informações sobre os quatro recursos descritos no Wi-Fi Especificação de Gerenciamento de QoS da WFA e definidos na especificação 802.11. Seu aplicativo pode usar essa API para obter informações sobre os recursos de QoS da WFA de seu dispositivo e, se conectado, as funcionalidades de QoS da WFA de seu par e o estado dos recursos de QoS da WFA configurados para sua conexão atual. Um aplicativo que atualmente usa o QoS2 ou outras APIs de QoS pode usar isso para obter informações adicionais de QoS para fins de exibição de telemetria de desempenho ou interface do usuário. Usar essa API para informar as alterações de comportamento não é sua principal finalidade.

Para obter mais informações, consulte o exemplo de código em WLAN_QOS_INFO.
wlan_intf_opcode_autoconf_end
Valor: 0x0fffffff
Não usado.
wlan_intf_opcode_msm_start
Valor: 0x10000100
Não usado.
wlan_intf_opcode_statistics
O opcode usado para consultar estatísticas do driver. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_rssi
Opcode usado para consultar a força do sinal recebido. Esse opcode só pode ser usado em uma operação de consulta com a função WlanQueryInterface .
wlan_intf_opcode_msm_end
Valor: 0x1fffffff
Não usado.
wlan_intf_opcode_security_start
Valor: 0x20010000
Não usado.
wlan_intf_opcode_security_end
Valor: 0x2fffffff
Não usado.
wlan_intf_opcode_ihv_start
Valor: 0x30000000
Não usado.
wlan_intf_opcode_ihv_end
Valor: 0x3fffffff
Não usado.

Requisitos

Requisito Valor
Cabeçalho wlanapi.h

Confira também