Condividi tramite

enumerazione WLAN_INTF_OPCODE (wlanapi.h)

  • Articolo

Importante

Alcune informazioni si riferiscono a un prodotto di versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce le costanti che specificano vari opcode usati per impostare e eseguire query sui parametri in un'interfaccia wireless. Queste costanti rappresentano i possibili opcode che è possibile passare il parametro OpCode alle funzioni WlanQueryInterface e WlanSetInterface per eseguire query o impostare parametri in un'interfaccia wireless.

Sintassi

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;

Costanti

 
wlan_intf_opcode_autoconf_start
Valore: 0x000000000
Non usato.
wlan_intf_opcode_autoconf_enabled
Il codice opcode usato per impostare o eseguire query sul fatto che la configurazione automatica sia abilitata.
wlan_intf_opcode_background_scan_enabled
Il codice opcode usato per impostare o eseguire query sul fatto che l'analisi in background sia abilitata.

L'analisi in background può essere disabilitata solo quando l'interfaccia si trova nello stato connesso. L'analisi in background è disabilitata se almeno un client lo disabilita.
Se l'interfaccia viene disconnessa, l'analisi in background verrà abilitata automaticamente.
wlan_intf_opcode_media_streaming_mode
Il codice opcode usato per impostare o eseguire query sulla modalità di streaming multimediale del driver.

La modalità di streaming multimediale può essere impostata solo quando l'interfaccia si trova nello stato connesso. La modalità di streaming multimediale è abilitata se almeno un client lo abilita. Se l'interfaccia viene disconnessa, la modalità di streaming multimediale viene disabilitata automaticamente
wlan_intf_opcode_radio_state
Il codice opcode usato per impostare o eseguire query sullo stato di radio.
wlan_intf_opcode_bss_type
Il codice opcode usato per impostare o eseguire query sul tipo BSS dell'interfaccia.
wlan_intf_opcode_interface_state
Il codice opcode usato per eseguire query sullo stato dell'interfaccia. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_current_connection
Il codice opcode usato per eseguire query sulle informazioni sulla connessione corrente dell'interfaccia.

Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface . Se l'interfaccia si trova in stato disconnesso o disconnesso, la funzione WlanQueryInterface restituisce ERROR_INVALID_STATE.
wlan_intf_opcode_channel_number
Il codice opcode usato per eseguire query sul canale corrente in cui è operativa l'interfaccia wireless. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
Il codice opcode usato per eseguire query sulle coppie di autenticazione/crittografia supportate per la modalità infrastruttura. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
Il codice opcode usato per eseguire query sulle coppie di autenticazione/crittografia supportate per la modalità ad hoc. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_supported_country_or_region_string_list
Il codice opcode usato per eseguire query sull'elenco di stringhe di paese o area supportate. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_current_operation_mode
Il codice opcode usato per impostare o eseguire query sulla modalità di operazione corrente dell'interfaccia wireless. Per altre informazioni sulle modalità di operazione, vedere Modalità di operazione native 802.11.
wlan_intf_opcode_supported_safe_mode
Il codice opcode usato per eseguire query su se la combinazione miniport/NIC supporta la modalità FIPS (Federal Information Processing Standards). Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface . La modalità FIPS è nota anche come modalità sicura. Questa modalità sicura wireless è diversa dalla modalità sicura del sistema operativo.
wlan_intf_opcode_certified_safe_mode
Il codice opcode usato per eseguire query sul fatto che la combinazione miniport/scheda di interfaccia di rete sia certificata FIPS. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_hosted_network_capable
L'opcode usato per eseguire query sul supporto della rete ospitata nel driver di dispositivo associato all'interfaccia Wireless. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .

Il tipo di dati restituito per questo opcode da una query è un valore booleano. Un valore restituito di TRUE indica che la rete ospitata è supportata. Un valore false indica che la rete ospitata non è supportata.

Questo valore è un'estensione alle API wireless native aggiunte per supportare la rete ospitata wireless in Windows 7 e in Windows Server 2008 R2 con il servizio LAN wireless installato.
wlan_intf_opcode_management_frame_protection_capable
Il codice opcode usato per eseguire una query sul fatto che Management Frame Protection (MFP) sia supportato nel driver di dispositivo associato all'interfaccia Wireless. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .

MFP è definito nello standard IEEE 802.11w-2009 a 802.11.

Questo valore è supportato su Windows 8 e su Windows Server 2012.
wlan_intf_opcode_secondary_sta_interfaces
Consente ai client di eseguire query sulle informazioni sulla sta secondaria di un'interfaccia specificata. Restituisce un WLAN_INTERFACE_INFO_LIST di stA secondari nell'interfaccia specificata.
wlan_intf_opcode_secondary_sta_synchronized_connections
Opcode usato per eseguire query sul fatto che le connessioni sincronizzate di STA secondarie siano abilitate nell'interfaccia specificata.
wlan_intf_opcode_realtime_connection_quality
Un codice opcode che consente ai client di eseguire query sugli attributi che descrivono la qualità della connessione nell'interfaccia specificata. Questa API combina campi da varie altre API WLAN esistenti (wlan_intf_opcode_current_connection e WlanGetNetworkBssList), ma omette informazioni sensibili alla posizione e per questo motivo non richiede privilegi di accesso alla posizione.

Questo codice opcode recupera una struttura che contiene attributi che descrivono la qualità della connessione nell'interfaccia specificata. Avrà esito negativo se l'interfaccia non è connessa. L'app può usare questa API per ottenere informazioni sullo stato e sulla qualità della connessione Wi-Fi( l'API dispone di applicazioni per lo streaming, la videoconferenza e altre operazioni sensibili alla qualità della rete. Le app che attualmente usano wlan_intf_opcode_current_connection e WlanGetNetworkBssList per recuperare le informazioni sulla qualità della connessione, ma non vogliono richiedere l'accesso alla posizione, possono usare questa API.

Per altre informazioni, vedere l'esempio di codice in WLAN_REALTIME_CONNECTION_QUALITY.
wlan_intf_opcode_qos_info
Un opcode che consente ai client di eseguire query sullo stato delle funzionalità di qualità del servizio (QoS) descritte dalla Wi-Fi QoS Management Specification dell'Alleanza Wi-Fi e definite nella specifica 802.11.

Questo codice opcode recupera una struttura che contiene informazioni sulle quattro funzionalità descritte nella specifica di gestione di WFA Wi-Fi QoS e definita nella specifica 802.11. L'app può usare questa API per ottenere informazioni sulle funzionalità WFA QoS del dispositivo e, se connesso, le funzionalità WFA QoS del peer e lo stato delle funzionalità WFA QoS configurate per la connessione corrente. Un'app che attualmente usa le API QoS2 o altre API QoS può usare questa funzionalità per ottenere informazioni QoS aggiuntive per i dati di telemetria delle prestazioni o gli scopi di visualizzazione dell'interfaccia utente. L'uso di questa API per informare le modifiche al comportamento non è il suo scopo principale.

Per altre informazioni, vedere l'esempio di codice in WLAN_QOS_INFO.
wlan_intf_opcode_autoconf_end
Valore: 0x0fffffff
Non usato.
wlan_intf_opcode_msm_start
Valore: 0x10000100
Non usato.
wlan_intf_opcode_statistics
Il codice opcode usato per eseguire query sulle statistiche del driver. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_rssi
Opcode usato per eseguire query sulla forza del segnale ricevuta. Questo opcode può essere usato solo in un'operazione di query con la funzione WlanQueryInterface .
wlan_intf_opcode_msm_end
Valore: 0x1fffffff
Non usato.
wlan_intf_opcode_security_start
Valore: 0x20010000
Non usato.
wlan_intf_opcode_security_end
Valore: 0x2fffffff
Non usato.
wlan_intf_opcode_ihv_start
Valore: 0x30000000
Non usato.
wlan_intf_opcode_ihv_end
Valore: 0x3fffffff
Non usato.

Requisiti

Requisito Valore
Intestazione wlanapi.h

Vedi anche