Freigeben über


WLAN_INTF_OPCODE-Aufzählung (wlanapi.h)

Von Bedeutung

Einige Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der kommerziellen Veröffentlichung erheblich geändert werden kann. Microsoft gibt keine Garantie, weder ausdrücklich noch impliziert, hinsichtlich der hier bereitgestellten Informationen.

Definiert Konstanten, die verschiedene Opcodes angeben, die zum Festlegen und Abfragen von Parametern auf einer drahtlosen Schnittstelle verwendet werden. Diese Konstanten stellen die möglichen Opcodes dar, die Sie im OpCode-Parameter an die Funktionen WlanQueryInterface und WlanSetInterface übergeben können, um Parameter für eine drahtlose Schnittstelle abzufragen oder festzulegen.

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;

Konstanten

 
wlan_intf_opcode_autoconf_start
Wert: 0x000000000
Nicht verwendet.
wlan_intf_opcode_autoconf_enabled
Der zum Festlegen oder Abfragen verwendete Opcode, ob die automatische Konfiguration aktiviert ist.
wlan_intf_opcode_background_scan_enabled
Der opcode, der verwendet wird, um festzulegen oder abzufragen, ob die Hintergrundüberprüfung aktiviert ist.

Der Hintergrundscan kann nur deaktiviert werden, wenn sich die Schnittstelle im verbundenen Zustand befindet. Die Hintergrundüberprüfung ist deaktiviert, wenn mindestens ein Client sie deaktiviert.
Wenn die Schnittstelle getrennt wird, wird der Hintergrundscan automatisch aktiviert.
wlan_intf_opcode_media_streaming_mode
Der opcode, der zum Festlegen oder Abfragen des Medienstreamingmodus des Treibers verwendet wird.

Der Medienstreamingmodus kann nur festgelegt werden, wenn sich die Schnittstelle im verbundenen Zustand befindet. Der Medienstreamingmodus ist aktiviert, wenn mindestens ein Client ihn aktiviert. Wenn die Schnittstelle getrennt wird, wird der Medienstreamingmodus automatisch deaktiviert.
wlan_intf_opcode_radio_state
Der zum Festlegen oder Abfragen des Funkzustands verwendete Opcode.
wlan_intf_opcode_bss_type
Der zum Festlegen oder Abfragen des BSS-Typs der Schnittstelle verwendete Opcode.
wlan_intf_opcode_interface_state
Der zum Abfragen des Status der Schnittstelle verwendete Opcode. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_current_connection
Der Opcode, der verwendet wird, um Informationen zur aktuellen Verbindung der Schnittstelle abzufragen.

Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden. Wenn sich die Schnittstelle im getrennten oder getrennten Zustand befindet, gibt die WlanQueryInterface-FunktionERROR_INVALID_STATE zurück.
wlan_intf_opcode_channel_number
Der opcode, der zum Abfragen des aktuellen Kanals verwendet wird, auf dem die drahtlose Schnittstelle ausgeführt wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs
Der opcode, der zum Abfragen der unterstützten Authentifizierungs-/Chiffrepaare für den Infrastrukturmodus verwendet wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_supported_adhoc_auth_cipher_pairs
Der opcode, der zum Abfragen der unterstützten Authentifizierungs-/Chiffrepaare für den Ad-hoc-Modus verwendet wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_supported_country_or_region_string_list
Der Opcode, der zum Abfragen der Liste der unterstützten Länder- oder Regionszeichenfolgen verwendet wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_current_operation_mode
Der opcode, der zum Festlegen oder Abfragen des aktuellen Betriebsmodus der drahtlosen Schnittstelle verwendet wird. Weitere Informationen zu Vorgangsmodi finden Sie unter Native 802.11-Vorgangsmodi.
wlan_intf_opcode_supported_safe_mode
Der opcode, der verwendet wird, um abzufragen, ob die Miniport/NIC-Kombination den FIPS-Modus (Federal Information Processing Standards) unterstützt. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden. DER FIPS-Modus wird auch als abgesicherter Modus bezeichnet. Dieser drahtlose abgesicherte Modus unterscheidet sich vom abgesicherten Betriebssystemmodus.
wlan_intf_opcode_certified_safe_mode
Der opcode, der verwendet wird, um abzufragen, ob die Miniport/NIC-Kombination FIPS zertifiziert ist. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_hosted_network_capable
Der Opcode, der verwendet wird, um die Unterstützung des gehosteten Netzwerks im Gerätetreiber abzufragen, der der Drahtlosen Schnittstelle zugeordnet ist. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.

Der von einer Abfrage zurückgegebene Datentyp für diesen Opcode ist ein Boolescher Wert. Ein von TRUE zurückgegebener Wert gibt an, dass gehostetes Netzwerk unterstützt wird. Ein Wert von FALSE gibt an, dass gehostetes Netzwerk nicht unterstützt wird.

Dieser Wert ist eine Erweiterung für systemeigene drahtlose APIs, die hinzugefügt werden, um das drahtlose gehostete Netzwerk unter Windows 7 und unter Windows Server 2008 R2 mit dem installierten Wireless LAN-Dienst zu unterstützen.
wlan_intf_opcode_management_frame_protection_capable
Der opcode, der verwendet wird, um abzufragen, ob Management Frame Protection (MFP) im Gerätetreiber unterstützt wird, der der Drahtlosen Schnittstelle zugeordnet ist. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.

MFP ist im IEEE 802.11w-2009-Änderungsantrag zu 802.11-Standard definiert.

Dieser Wert wird unter Windows 8 und unter Windows Server 2012 unterstützt.
wlan_intf_opcode_secondary_sta_interfaces
Ermöglicht Clients das Abfragen von Informationen zum sekundären STA einer bestimmten Schnittstelle. Gibt einen WLAN_INTERFACE_INFO_LIST sekundärer STAs auf der angegebenen Schnittstelle zurück.
wlan_intf_opcode_secondary_sta_synchronized_connections
Opcode, der verwendet wird, um abzufragen, ob sekundäre STA-synchronisierte Verbindungen auf der angegebenen Schnittstelle aktiviert sind.
wlan_intf_opcode_realtime_connection_quality
Ein Opcode, mit dem Clients Attribute abfragen können, die die Qualität der Verbindung auf der angegebenen Schnittstelle beschreiben. Diese API kombiniert Felder aus verschiedenen anderen vorhandenen WLAN-APIs (wlan_intf_opcode_current_connection und WlanGetNetworkBssList), lässt jedoch standortbezogene Informationen aus und erfordert daher keine Standortzugriffsrechte.

Dieser Opcode ruft eine Struktur ab, die Attribute enthält, die die Qualität der Verbindung auf der angegebenen Schnittstelle beschreiben. Wenn die Schnittstelle nicht verbunden ist, tritt ein Fehler auf. Ihre App kann diese API verwenden, um Informationen über den Status und die Qualität ihrer WLAN-Verbindung zu erhalten (die API verfügt über Anwendungen zum Streamen, Videokonferenzen und anderen vorgängen mit Netzwerkqualität. Apps, die derzeit wlan_intf_opcode_current_connection und WlanGetNetworkBssList verwenden, um Verbindungsqualitätsinformationen abzurufen, aber keinen Wunsch haben, den Standortzugriff anzufordern, können diese API verwenden.

Weitere Informationen finden Sie im Codebeispiel in WLAN_REALTIME_CONNECTION_QUALITY.
wlan_intf_opcode_qos_info
Ein Opcode, mit dem Clients den Status der QoS-Features (Quality-of-Service) abfragen können, die von der Wi-Fi Alliance Wi-Fi QoS Management Specification beschrieben und in der Spezifikation 802.11 definiert sind.

Dieser Opcode ruft eine Struktur ab, die Informationen zu den vier Features enthält, die in der Wi-Fi QoS-Verwaltungsspezifikation der WFA beschrieben und in der Spezifikation 802.11 definiert sind. Ihre App kann diese API verwenden, um Informationen über die WFA-QoS-Funktionen des Geräts abzurufen, und wenn sie verbunden sind, die WFA QoS-Funktionen des Peers und den Status der für die aktuelle Verbindung konfigurierten WFA-QoS-Features. Eine App, die derzeit QoS2 oder andere QoS-APIs verwendet, kann dies verwenden, um zusätzliche QoS-Informationen für Leistungs telemetrie- oder UI-Anzeigezwecke abzurufen. Die Verwendung dieser API zum Informieren von Verhaltensänderungen ist nicht der hauptzweck.

Weitere Informationen finden Sie im Codebeispiel in WLAN_QOS_INFO.
wlan_intf_opcode_autoconf_end
Wert: 0x0fffffff
Nicht verwendet.
wlan_intf_opcode_msm_start
Wert: 0x10000100
Nicht verwendet.
wlan_intf_opcode_statistics
Der opcode, der zum Abfragen von Treiberstatistiken verwendet wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_rssi
Opcode, der verwendet wird, um die Empfangene Signalstärke abzufragen. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_msm_end
Wert: 0x1fffffff
Nicht verwendet.
wlan_intf_opcode_security_start
Wert: 0x20010000
Nicht verwendet.
wlan_intf_opcode_security_end
Wert: 0x2fffffff
Nicht verwendet.
wlan_intf_opcode_ihv_start
Wert: 0x30000000
Nicht verwendet.
wlan_intf_opcode_ihv_end
Wert: 0x3fffffff
Nicht verwendet.

Anforderungen

Anforderung Wert
Header wlanapi.h

Siehe auch