énumération WLAN_INTF_OPCODE (wlanapi.h)

Article
03/14/2024

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

Partager via

énumération WLAN_INTF_OPCODE (wlanapi.h)

Syntax

Constantes

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires