WLAN_INTF_OPCODE-Enumeration (wlanapi.h)

  • Artikel

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert Konstanten, die verschiedene Opcodes angeben, die zum Festlegen und Abfragen von Parametern für eine drahtlose 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
Wird nicht verwendet.
wlan_intf_opcode_autoconf_enabled
Der opcode, mit dem festgelegt oder abgefragt wird, ob die automatische Konfiguration aktiviert ist.
wlan_intf_opcode_background_scan_enabled
Der Opcode, mit dem festgelegt oder abgefragt wird, ob die Hintergrundüberprüfung aktiviert ist.

Die Hintergrundüberprüfung kann nur deaktiviert werden, wenn sich die Schnittstelle im verbundenen Zustand befindet. Die Hintergrundüberprüfung ist deaktiviert, wenn sie von mindestens einem Client deaktiviert wird.
Wenn die Schnittstelle getrennt wird, wird die Hintergrundüberprüfung 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 er von mindestens einem Client aktiviert wird. Wenn die Schnittstelle getrennt wird, wird der Medienstreamingmodus automatisch deaktiviert.
wlan_intf_opcode_radio_state
Der opcode, der zum Festlegen oder Abfragen des Funkstatus verwendet wird.
wlan_intf_opcode_bss_type
Der opcode, der zum Festlegen oder Abfragen des BSS-Typs der Schnittstelle verwendet wird.
wlan_intf_opcode_interface_state
Der Opcode, der zum Abfragen des Zustands der Schnittstelle verwendet wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_current_connection
Der opcode, der zum Abfragen von Informationen zur aktuellen Verbindung der Schnittstelle verwendet wird.

Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden. Wenn sich die Schnittstelle in einem 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-/Verschlüsselungspaare 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-/Verschlüsselungspaare 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 Betriebsmodi finden Sie unter Native 802.11-Betriebsmodi.
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 Modus des Betriebssystems.
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 zum Abfragen der Unterstützung für gehostetes Netzwerk im Gerätetreiber verwendet wird, der der Wireless-Schnittstelle zugeordnet ist. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.

Der datentyp, der für diesen opcode von einer Abfrage zurückgegeben wird, ist ein boolescher Datentyp. Ein wert, der von TRUE zurückgegeben wird, gibt an, dass gehostetes Netzwerk unterstützt wird. Der Wert FALSE gibt an, dass das gehostete Netzwerk nicht unterstützt wird.

Dieser Wert ist eine Erweiterung für native Drahtlos-APIs, die zur Unterstützung des gehosteten Drahtlosnetzwerks unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst hinzugefügt wurden.
wlan_intf_opcode_management_frame_protection_capable
Der opcode, der verwendet wird, um abzufragen, ob der Management Frame Protection (MFP) in dem Gerätetreiber unterstützt wird, der der Wireless-Schnittstelle zugeordnet ist. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.

MFP ist in der IEEE 802.11w-2009-Änderung auf 802.11-Standard definiert.

Dieser Wert wird auf Windows 8 und auf 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 eine WLAN_INTERFACE_INFO_LIST sekundärer STAs für die angegebene Schnittstelle zurück.
wlan_intf_opcode_secondary_sta_synchronized_connections
Opcode wird verwendet, um abzufragen, ob sekundäre STA-synchronisierte Verbindungen für die angegebene Schnittstelle aktiviert sind.
wlan_intf_opcode_realtime_connection_quality
Ein Opcode, mit dem Clients Attribute abfragen können, die die Qualität der Verbindung für die angegebene Schnittstelle beschreiben. Diese API kombiniert Felder aus verschiedenen anderen vorhandenen WLAN-APIs (wlan_intf_opcode_current_connection und WlanGetNetworkBssList), lässt jedoch standortsensible Informationen aus, und aus diesem Grund sind keine Standortzugriffsrechte erforderlich.

Dieser Opcode ruft eine Struktur ab, die Attribute enthält, die die Qualität der Verbindung für die angegebene Schnittstelle beschreiben. Es tritt ein Fehler auf, wenn die Schnittstelle nicht verbunden ist. Ihre App kann diese API verwenden, um Informationen über den Zustand und die Qualität ihrer WLAN-Verbindung abzurufen (die API verfügt über Anwendungen für Streaming, Videokonferenzen und andere vorgänge mit Netzwerkqualität. Apps, die derzeit wlan_intf_opcode_current_connection und WlanGetNetworkBssList verwenden, um Informationen zur Verbindungsqualität abzurufen, aber keinen Zugriff auf den Standort anfordern möchten, 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 in der Wi-Fi QoS-Verwaltungsspezifikation der Wi-Fi Alliance 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 Management Specification der WFA beschrieben und in der 802.11-Spezifikation definiert sind. Ihre App kann diese API verwenden, um Informationen über die WFA-QoS-Funktionen ihres Geräts und, falls verbunden, die WFA-QoS-Funktionen ihres Peers und den Status der für die aktuelle Verbindung konfigurierten WFA-QoS-Features abzurufen. Eine App, die derzeit die QoS2- oder andere QoS-APIs verwendet, kann dies verwenden, um zusätzliche QoS-Informationen für Leistungstelemetrie- oder Ui-Anzeigezwecke abzurufen. Die Verwendung dieser API zum Informieren von Verhaltensänderungen ist nicht der primäre Zweck.

Weitere Informationen finden Sie im Codebeispiel in WLAN_QOS_INFO.
wlan_intf_opcode_autoconf_end
Wert: 0x0fffffff
Wird nicht verwendet.
wlan_intf_opcode_msm_start
Wert: 0x10000100
Wird 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 zum Abfragen der empfangenen Signalstärke verwendet wird. Dieser Opcode kann nur in einem Abfragevorgang mit der WlanQueryInterface-Funktion verwendet werden.
wlan_intf_opcode_msm_end
Wert: 0x1fffffff
Wird nicht verwendet.
wlan_intf_opcode_security_start
Wert: 0x20010000
Wird nicht verwendet.
wlan_intf_opcode_security_end
Wert: 0x2fffffff
Wird nicht verwendet.
wlan_intf_opcode_ihv_start
Wert: 0x30000000
Wird nicht verwendet.
wlan_intf_opcode_ihv_end
Wert: 0x3fffffff
Wird nicht verwendet.

Anforderungen

Anforderung Wert
Header wlanapi.h

Weitere Informationen