Freigeben über


DOT11_EXTSTA_ATTRIBUTES Struktur (windot11.h)

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.
 
Die DOT11_EXTSTA_ATTRIBUTES-Struktur definiert die physischen und betriebsfähigen Attribute des Miniporttreibers und der 802.11-Station, wenn sie im Extensible Station-Modus (Extensible Station) betrieben werden. Weitere Informationen zu diesem Betriebsmodus finden Sie unter Betriebsmodus für erweiterbare Station.

Syntax

typedef struct DOT11_EXTSTA_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredBSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uExcludedMacAddressListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uKeyMappingTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  ULONG                           uPMKIDCacheSize;
  ULONG                           uMaxNumPerSTADefaultKeyTables;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  UCHAR                           ucSupportedQoSProtocolFlags;
  BOOLEAN                         bSafeModeImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
  ULONG                           uAdhocNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedUcastAlgoPairs;
  ULONG                           uAdhocNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedMcastAlgoPairs;
  BOOLEAN                         bAutoPowerSaveMode;
  ULONG                           uMaxNetworkOffloadListSize;
  BOOLEAN                         bMFPCapable;
  ULONG                           uInfraNumSupportedMcastMgmtAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;

Member

Header

Der Typ, die Revision und die Größe der DOT11_EXTSTA_ATTRIBUTES Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen.

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieser Member muss gemäß dem Betriebssystem, unter dem der Treiber ausgeführt werden soll, auf einen der folgenden Werte festgelegt werden:

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista mit Service Pack 1 (SP1) oder höheren Versionen der Windows-Betriebssysteme

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8 oder höherer Versionen der Windows-Betriebssysteme

Diese Werte bestimmen, wie das Betriebssystem den bSafeModeImplemented-Member interpretiert.

Size

Dieser Member muss auf sizeof(DOT11_EXTSTA_ATTRIBUTES) festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uScanSSIDListSize

Die maximale Anzahl von Service Set Identifiers (SSIDs), die von der Station 802.11 für Scanvorgänge unterstützt werden. Die Station 802.11 muss eine SSID-Liste mit mindestens vier Einträgen unterstützen.

Die SSID-Liste, die die 802.11-Station für die Überprüfung verwendet, wird angegeben, wenn OID_DOT11_SCAN_REQUEST festgelegt ist.

uDesiredBSSIDListSize

Die maximale Anzahl von Einträgen in der gewünschten Liste der grundlegenden Dienstsatzbezeichner (BSSIDs), die von der Station 802.11 unterstützt werden. Die Station 802.11 muss eine BSSID-Liste mit mindestens einem Eintrag unterstützen.

Weitere Informationen zur gewünschten BSSID-Liste finden Sie unter OID_DOT11_DESIRED_BSSID_LIST.

uDesiredSSIDListSize

Die maximale Anzahl von Einträgen in der gewünschten SSID-Liste, die von der Station 802.11 unterstützt wird. Die Station 802.11 muss eine gewünschte SSID-Liste mit mindestens einem Eintrag unterstützen.

Weitere Informationen zur gewünschten SSID-Liste finden Sie unter OID_DOT11_DESIRED_SSID_LIST.

uExcludedMacAddressListSize

Die maximale Anzahl von Einträgen in der Liste der ausgeschlossenen MAC-Adressen, die von der Station 802.11 unterstützt werden. Die Station 802.11 muss eine ausgeschlossene MAC-Adressliste mit mindestens vier Einträgen unterstützen.

Weitere Informationen zur gewünschten Liste ausgeschlossener MAC-Adressen finden Sie unter OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.

uPrivacyExemptionListSize

Die maximale Anzahl von Einträgen in der Liste der Datenschutzausnahmen, die von der Station 802.11 unterstützt wird. Die Station 802.11 muss eine Liste der Datenschutzausnahmen mit mindestens einem Eintrag unterstützen.

Weitere Informationen zur Liste der Datenschutzausnahmen finden Sie unter OID_DOT11_PRIVACY_EXEMPTION_LIST.

uKeyMappingTableSize

Die maximale Anzahl von Verschlüsselungsschlüsseln, die von der Station 802.11 unterstützt werden. Es wird empfohlen, dass die 802.11-Station mindestens 32 Schlüsselzuordnungsschlüssel unterstützt.

Weitere Informationen zu Schlüsselzuordnungsschlüsseln finden Sie unter OID_DOT11_CIPHER_KEY_MAPPING_KEY.

uDefaultKeyTableSize

Die maximale Anzahl von Verschlüsselungsschlüsseln, die die 802.11-Station für die Standardschlüsseltabellen und die Standardschlüsseltabellen pro Station unterstützt.

Für Verschlüsselungsalgorithmen der Standardversion 802.11 muss die 802.11-Station eine Tabellengröße von mindestens vier Verschlüsselungsschlüsseln unterstützen. Bei Verschlüsselungsalgorithmen, die vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) entwickelt wurden, kann die Tabellengröße vier oder mehr betragen.

uWEPKeyValueMaxLength

Die maximale Länge eines von der Station 802.11 unterstützten WEP-Verschlüsselungsschlüssels in Bytes.

In der folgenden Tabelle sind die minimalen und maximalen Schlüssellängen in Bytes für die verschiedenen WEP-Verschlüsselungswerte aufgeführt, die über DOT11_CIPHER_ALGORITHM definiert werden.

WEP-Verschlüsselung Minimale Schlüssellänge Maximale Schlüssellänge
DOT11_CIPHER_ALGO_WEP40 5 5
DOT11_CIPHER_ALGO_WEP104 13 13
DOT11_CIPHER_ALGO_WEP 13 Beliebige Länge, die von der Station 802.11 unterstützt wird

uPMKIDCacheSize

Die maximale Anzahl von Einträgen im paarweise master Schlüsselbezeichnercache (PMKID), die von der 802.11-Station unterstützt wird.

Wenn die Station 802.11 keinen PMKID-Cache unterstützt, muss der Miniporttreiber diesen Member auf 0 festlegen. Andernfalls muss die 802.11-Station eine PMKID-Cachegröße von mindestens drei Einträgen unterstützen.

Weitere Informationen zum PMKID-Cache finden Sie unter OID_DOT11_PMKID_LIST.

uMaxNumPerSTADefaultKeyTables

Die maximale Anzahl von Standardschlüsseltabellen pro Station, die von der Station 802.11 unterstützt werden. Es wird empfohlen, dass die Station 802.11 mindestens 32 Standardschlüsseltabellen pro Station unterstützt.

Weitere Informationen zu standardmäßigen Verschlüsselungsschlüsseltabellen pro Station finden Sie unter Standardschlüssel pro Station.

bStrictlyOrderedServiceClassImplemented

Ein boolescher Wert, der bei Festlegung auf TRUE angibt, dass die 802.11-Station die IEEE 802.11 StrictlyOrdered-Dienstklasse für die Mac-Dienstdateneinheit(MSDU)-Paketübermittlung unterstützt.

Weitere Informationen zur StrictlyOrdered-Dienstklasse finden Sie in Klausel 5.1.3 des IEEE 802.11-2012-Standards.

ucSupportedQoSProtocolFlags

Eine Reihe von Flags, die die QoS-Protokolle (Quality of Service) angeben, die die NIC implementiert. Dieses Element ist entweder 0 oder eine bitweise OR-Kombination der folgenden Flags:

DOT11_QOS_PROTOCOL_FLAG_WMM

Die NIC implementiert das 802.11 WMM-QoS-Protokoll.

DOT11_QOS_PROTOCOL_FLAG_11E

Die NIC implementiert das QoS-Protokoll 802.11e.

bSafeModeImplemented

Die Unterstützungsfunktion im abgesicherten Modus der Kombination NIC/Miniport-Treiber. Das Betriebssystem interpretiert diesen Member je nach Dem Wert von Header.Revision unterschiedlich:

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Das Betriebssystem interpretiert den bSafeModeImplemented-Member als booleschen Wert. Wenn dieser Wert TRUE ist, implementiert die NIC den sicheren Betriebsmodus 802.11. Andernfalls ist der Wert FALSE.

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 oder höher

Das Betriebssystem interpretiert den bSafeModeImplemented-Member als Bitfeld mit den folgenden möglichen Bitwerten:

  • Wenn das Bitfeld auf DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED festgelegt ist, ohne dass andere Bits festgelegt sind, implementiert der Miniporttreiber den sicheren Betriebsmodus 802.11.
  • Wenn das Bitfeld auf DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED festgelegt ist, hat die NIC/Miniport-Kombination vom National Institute of Standards and Technology (NIST) ein Validierungszertifikat gemäß fips Veröffentlichung 140-2, Sicherheitsanforderungen für kryptografische Module erhalten.
Dieses Element wird in Verbindung mit OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

Die Anzahl der länder- oder regionsspezifischen Zeichenfolgen, die von der Station 802.11 unterstützt werden. Wenn die Station 802.11 mehrere Regulierungsdomänen unterstützt, wie durch den IEEE 802.11d-2001-Standard angegeben, identifiziert jede Länder- oder Regionszeichenfolge eine regulatorische Domäne, die von der Station 802.11 unterstützt wird.

Wenn die Station 802.11 den IEEE 802.11d-2001-Standard nicht unterstützt, muss der Miniporttreiber uNumSupportedCountryOrRegionStrings auf Null festlegen.

pSupportedCountryOrRegionStrings

Ein Zeiger auf ein Array von 802.11d-Länder- oder Regionszeichenfolgen, die von der Station 802.11 unterstützt werden. Jeder Eintrag im Array ist als formatiert. DOT11_COUNTRY_OR_REGION_STRING-Struktur .

uInfraNumSupportedUcastAlgoPairs

Die Anzahl der Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Unicastpaketen unterstützt werden, wenn sie für den Betrieb in einem BSS-Netzwerk (Infrastructure Basic Service Set) konfiguriert sind. Der uInfraNumSupportedUcastAlgoPairs-Member muss die Anzahl DOT11_AUTH_CIPHER_PAIR Strukturen in dem Array sein, auf das vom pInfraSupportedUcastAlgoPairs-Member verwiesen wird .

pInfraSupportedUcastAlgoPairs

Ein Zeiger auf ein Array von Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Unicastpaketen in einem BSS-Infrastrukturnetzwerk unterstützt werden. Jeder Eintrag im Array ist als formatiert. DOT11_AUTH_CIPHER_PAIR Struktur.

uInfraNumSupportedMcastAlgoPairs

Die Anzahl der Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Multicast- und Broadcastpaketen unterstützt werden, wenn sie für den Betrieb in einem BSS-Netzwerk (Infrastructure Basic Service Set) konfiguriert sind. Der uInfraNumSupportedMcastAlgoPairs-Member muss die Anzahl der DOT11_AUTH_CIPHER_PAIR Strukturen in dem Array sein, auf das vom pInfraSupportedMcastAlgoPairs-Member verwiesen wird .

pInfraSupportedMcastAlgoPairs

Ein Zeiger auf ein Array von Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Multicast- und Broadcastpaketen in einem BSS-Infrastrukturnetzwerk unterstützt werden. Jeder Eintrag im Array ist als formatiert. DOT11_AUTH_CIPHER_PAIR Struktur.

uAdhocNumSupportedUcastAlgoPairs

Die Anzahl der Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Unicastpaketen unterstützt werden, wenn sie für den Betrieb in einem unabhängigen BSS-Netzwerk (IBSS) konfiguriert sind. Der uAdhocNumSupportedUcastAlgoPairs-Member muss die Anzahl der DOT11_AUTH_CIPHER_PAIR Strukturen im Array sein, auf die vom pAdhocSupportedUcastAlgoPairs-Member verwiesen wird.

pAdhocSupportedUcastAlgoPairs

Ein Zeiger auf ein Array von Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Unicastpaketen in einem IBSS-Netzwerk unterstützt werden. Jeder Eintrag im Array ist als formatiert. DOT11_AUTH_CIPHER_PAIR Struktur.

uAdhocNumSupportedMcastAlgoPairs

Die Anzahl der Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Multicast- und Broadcastpaketen unterstützt werden, wenn sie für den Betrieb in einem IBSS-Netzwerk konfiguriert sind. Der uAdhocNumSupportedMcastAlgoPairs-Member muss die Anzahl der DOT11_AUTH_CIPHER_PAIR Strukturen in dem Array sein, auf das vom pAdhocSupportedMcastAlgoPairs-Member verwiesen wird.

pAdhocSupportedMcastAlgoPairs

Ein Zeiger auf ein Array von Authentifizierungs- und Verschlüsselungsalgorithmen, die von der 802.11-Station zum Senden und Empfangen von Multicast- und Broadcastpaketen in einem IBSS-Netzwerk unterstützt werden. Jeder Eintrag im Array ist als formatiert. DOT11_AUTH_CIPHER_PAIR Struktur.

bAutoPowerSaveMode

Die Unterstützungsfunktion der NIC/Miniport-Treiberkombination zur autonomen Verwaltung der Stromversorgung, einschließlich Erkennung und Aushandlung der richtigen Wi-Fi Stromsparmodus (PSM) zwischen dem Gerät und dem Wi-Fi Access Point. NDIS 6.30-konform Wi-Fi Miniporttreiber sollten diesen Member auf TRUE festlegen.

uMaxNetworkOffloadListSize

Die maximale Anzahl von Netzwerken, die ein Miniporttreiber auslagern kann, wenn er die Netzwerklistenauslagerungsfunktion unterstützen kann.

bMFPCapable

Die Unterstützungsfunktion des NIC/Miniport-Treibers zur Unterstützung des Verwaltungsrahmenschutzes zwischen dem Gerät und dem Wi-Fi Access Point, wie in der Spezifikation 802.11w-2009 angegeben. Legen Sie bei Unterstützung auf TRUE fest. Andernfalls sollte dieser Member auf FALSE festgelegt werden.

uInfraNumSupportedMcastMgmtAlgoPairs

Die Länge des Arrays von Authentifizierungs- und Verschlüsselungsalgorithmuspaaren, auf die in pInfraSupportedMcastMgmtAlgoPairs verwiesen wird.

pInfraSupportedMcastMgmtAlgoPairs

Ein Zeiger auf ein Array von Authentifizierungs- und Verschlüsselungsalgorithmuspaaren, das das Gerät für MFP im Infrastrukturmodus unterstützt. Die empfohlene Verschlüsselung für Windows 8 ist BIP mit WPA- oder WPA2-Authentifizierung. Jeder Eintrag im Array ist als formatiert. DOT11_AUTH_CIPHER_PAIR Struktur.

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

Hinweise

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES-Struktur enthält ein Element (pExtSTAAttributes), das die Adresse einer DOT11_EXTSTA_ATTRIBUTES-Struktur angibt. Wenn der Miniporttreiber NdisMSetMiniportAttributes aufruft, legt der Treiber den MiniportAttributes-Parameter auf die Adresse eines vom Treiber zugewiesenen Speicherblocks fest, der eine NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES-Struktur zusammen mit der DOT11_EXTSTA_ATTRIBUTES-Struktur enthält.

Die MfPR-Erzwingung (Management Frame Protection Required) für Windows 8 wird nicht unterstützt. Daher sollten Miniporttreiber dieses Bit niemals während einer Zuordnungsanforderung in den RSN-Funktionen von RSN IE festlegen. Für eine Richtlinie kann der Zugriffspunkt MFPR ankündigen, wodurch MFP-fähige STA zugeordnet werden kann. Die Zuordnung von Zugriffspunkten, die MFP-Funktionen nicht unterstützen, schlägt fehl. Wenn MFPR von einem Zugriffspunkt festgelegt wird und STA nicht MFP-fähig ist, behandelt Windows 8 das Netzwerk als nicht übereinstimmend und sendet keine Zuordnungsanforderung an den Miniport.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 8 und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile windot11.h (include Ndis.h)

Weitere Informationen

Erweiterbarer Stationsbetriebsmodus

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

Standardschlüssel pro Station

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST