Partager via

énumération WLAN_INTF_OPCODE (wlanapi.h)

  • Article

Important

Certaines informations se rapportent à un produit de préversion qui peut être sensiblement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit des constantes qui spécifient différents opcodes utilisés pour définir et interroger des paramètres sur une interface sans fil. Ces constantes représentent les opcodes possibles que vous pouvez transmettre le paramètre OpCode aux fonctions WlanQueryInterface et WlanSetInterface pour interroger ou définir des paramètres sur une interface sans fil.

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
Valeur : 0x000000000
Non utilisé.
wlan_intf_opcode_autoconf_enabled
Opcode utilisé pour définir ou interroger si la configuration automatique est activée.
wlan_intf_opcode_background_scan_enabled
Opcode utilisé pour définir ou interroger si l’analyse en arrière-plan est activée.

L’analyse en arrière-plan ne peut être désactivée que lorsque l’interface est à l’état connecté. L’analyse en arrière-plan est désactivée si au moins un client la désactive.
Si l’interface est déconnectée, l’analyse en arrière-plan est activée automatiquement.
wlan_intf_opcode_media_streaming_mode
Opcode utilisé pour définir ou interroger le mode de streaming multimédia du pilote.

Le mode de diffusion en continu multimédia ne peut être défini que lorsque l’interface est à l’état connecté. Le mode de streaming multimédia est activé si au moins un client l’active. Si l’interface est déconnectée, le mode de streaming multimédia est automatiquement désactivé
wlan_intf_opcode_radio_state
Opcode utilisé pour définir ou interroger l’état radio.
wlan_intf_opcode_bss_type
Opcode utilisé pour définir ou interroger le type BSS de l’interface.
wlan_intf_opcode_interface_state
Opcode utilisé pour interroger l’état de l’interface. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_current_connection
Opcode utilisé pour interroger des informations sur la connexion actuelle de l’interface.

Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface . Si l’interface est déconnectée ou déconnectée, la fonction WlanQueryInterface retourne ERROR_INVALID_STATE.
wlan_intf_opcode_channel_number
Opcode utilisé pour interroger le canal actuel sur lequel l’interface sans fil fonctionne. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
Opcode utilisé pour interroger les paires d’authentification/chiffrement prises en charge pour le mode infrastructure. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
Opcode utilisé pour interroger les paires d’authentification/chiffrement prises en charge pour le mode ad hoc. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_supported_country_or_region_string_list
Opcode utilisé pour interroger la liste des chaînes de pays ou de régions prises en charge. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_current_operation_mode
Opcode utilisé pour définir ou interroger le mode de fonctionnement actuel de l’interface sans fil. Pour plus d’informations sur les modes de fonctionnement, consultez Modes de fonctionnement natifs 802.11.
wlan_intf_opcode_supported_safe_mode
Opcode utilisé pour demander si la combinaison miniport/NIC prend en charge le mode FIPS (Federal Information Processing Standards). Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface . Le mode FIPS est également appelé mode sans échec. Ce mode sans échec sans fil est différent du mode sans échec du système d’exploitation.
wlan_intf_opcode_certified_safe_mode
Opcode utilisé pour interroger si la combinaison miniport/carte réseau est certifiée FIPS. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_hosted_network_capable
Opcode utilisé pour interroger la prise en charge du réseau hébergé dans le pilote de périphérique associé à l’interface sans fil. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .

Le type de données retourné pour cet opcode par une requête est booléen. Une valeur retournée de TRUE indique que le réseau hébergé est pris en charge. La valeur FALSE indique que le réseau hébergé n’est pas pris en charge.

Cette valeur est une extension des API sans fil natives ajoutées pour prendre en charge le réseau hébergé sans fil sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé.
wlan_intf_opcode_management_frame_protection_capable
Opcode utilisé pour demander si la protection des trames de gestion (MFP) est prise en charge dans le pilote de périphérique associé à l’interface sans fil. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .

MFP est défini dans la modification IEEE 802.11w-2009 de la norme 802.11.

Cette valeur est prise en charge sur Windows 8 et sur Windows Server 2012.
wlan_intf_opcode_secondary_sta_interfaces
Permet aux clients d’interroger des informations sur le sta secondaire d’une interface donnée. Retourne une WLAN_INTERFACE_INFO_LIST de stas secondaires sur l’interface donnée.
wlan_intf_opcode_secondary_sta_synchronized_connections
Opcode utilisé pour demander si les connexions synchronisées STA secondaires sont activées sur l’interface spécifiée.
wlan_intf_opcode_realtime_connection_quality
Opcode qui permet aux clients d’interroger les attributs qui décrivent la qualité de la connexion sur l’interface donnée. Cette API combine des champs de différentes autres API WLAN existantes (wlan_intf_opcode_current_connection et WlanGetNetworkBssList), mais elle omet les informations sensibles à l’emplacement et, pour cette raison, elle ne nécessite pas de privilèges d’accès à l’emplacement.

Cet opcode récupère une structure qui contient des attributs qui décrivent la qualité de la connexion sur l’interface donnée. Il échoue si l’interface n’est pas connectée. Votre application peut utiliser cette API pour obtenir des informations sur l’état et la qualité de sa connexion Wi-Fi (l’API a des applications de streaming, de visioconférence et d’autres opérations sensibles à la qualité du réseau. Les applications qui utilisent actuellement wlan_intf_opcode_current_connection et WlanGetNetworkBssList pour récupérer des informations de qualité de connexion, mais qui ne souhaitent pas demander l’accès à la localisation, peuvent utiliser cette API.

Pour plus d’informations, consultez l’exemple de code dans WLAN_REALTIME_CONNECTION_QUALITY.
wlan_intf_opcode_qos_info
Un opcode qui permet aux clients d’interroger l’état des fonctionnalités de qualité de service (QoS) décrites par la spécification de gestion Wi-Fi QoS de Wi-Fi Alliance et définies dans la spécification 802.11.

Cet opcode récupère une structure qui contient des informations sur les quatre fonctionnalités décrites dans la spécification de gestion qoS Wi-Fi de WFA et définies dans la spécification 802.11. Votre application peut utiliser cette API pour obtenir des informations sur les fonctionnalités QoS WFA de son appareil et, si elle est connectée, les fonctionnalités De QoS WFA de son homologue et l’état des fonctionnalités WFA QoS configurées pour sa connexion actuelle. Une application qui utilise actuellement la QoS2 ou d’autres API QoS peut l’utiliser pour obtenir des informations qoS supplémentaires à des fins de télémétrie des performances ou d’affichage de l’interface utilisateur. L’utilisation de cette API pour informer les changements de comportement n’est pas son objectif principal.

Pour plus d’informations, consultez l’exemple de code dans WLAN_QOS_INFO.
wlan_intf_opcode_autoconf_end
Valeur : 0x0fffffff
Non utilisé.
wlan_intf_opcode_msm_start
Valeur : 0x10000100
Non utilisé.
wlan_intf_opcode_statistics
Opcode utilisé pour interroger les statistiques de pilote. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_rssi
Opcode utilisé pour interroger la force du signal reçu. Cet opcode peut uniquement être utilisé dans une opération de requête avec la fonction WlanQueryInterface .
wlan_intf_opcode_msm_end
Valeur : 0x1fffffff
Non utilisé.
wlan_intf_opcode_security_start
Valeur : 0x20010000
Non utilisé.
wlan_intf_opcode_security_end
Valeur : 0x2fffffff
Non utilisé.
wlan_intf_opcode_ihv_start
Valeur : 0x30000000
Non utilisé.
wlan_intf_opcode_ihv_end
Valeur : 0x3fffffff
Non utilisé.

Spécifications

Condition requise Valeur
En-tête wlanapi.h

Voir aussi