DOT11_EXTSTA_SEND_CONTEXT-Struktur (windot11.h)

Artikel
03/05/2024

Wichtig Die native WLAN-Schnittstelle 802.11 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 driver model.

Die DOT11_EXTSTA_SEND_CONTEXT-Struktur definiert die nativen 802.11-Attribute eines Pakets, das vom Miniporttreiber gesendet werden soll, der im ExtSTA-Modus (Extensible Station) arbeitet. Weitere Informationen zu diesem Betriebsmodus finden Sie unter Betriebsmodus für erweiterbare Stationen.

Syntax

typedef struct DOT11_EXTSTA_SEND_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  USHORT             usExemptionActionType;
  ULONG              uPhyId;
  ULONG              uDelayedSleepValue;
  PVOID              pvMediaSpecificInfo;
  ULONG              uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;

Member

Header

Typ, Revision und Größe der DOT11_EXTSTA_SEND_CONTEXT-Struktur. Dieser Member 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 auf DOT11_EXTSTA_SEND_CONTEXT_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_EXTSTA_SEND_CONTEXT) festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

usExemptionActionType

Der Typ der Verschlüsselungsausnahme für das Paket. Die folgenden Ausnahmetypen sind definiert:

DOT11_EXEMPT_NO_EXEMPTION

Das Paket ist nicht von Verschlüsselungsvorgängen ausgenommen, die von der Station 802.11 ausgeführt werden.

DOT11_EXEMPT_ALWAYS

Das Paket ist von allen Verschlüsselungsvorgängen ausgenommen, die von der Station 802.11 ausgeführt werden. Die Station 802.11 muss das Paket unverschlüsselt übertragen.

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

Das Paket ist nur dann von allen Verschlüsselungsvorgängen ausgenommen, die von der 802.11-Station ausgeführt werden, wenn die Station keinen Schlüsselzuordnungsschlüssel für die MAC-Adresse (Destination Media Access Control) des Pakets hat. Weitere Informationen zu Schlüsselzuordnungsschlüsseln finden Sie unter 802.11 Verschlüsselungsschlüsseltypen.

uPhyId

Der Bezeichner (ID) eines PHY-Typs auf der Station 802.11. Die 802.11-Station muss den angegebenen PHY verwenden, um das Paket zu übertragen.

Der Wert von uPhyId muss einer der folgenden Sein:

Der Wert eines Eintrags in der Liste der aktiven PHY-Typen, die vom MIB-Objekt msDot11ActivePhyList definiert werden. Der Miniporttreiber legt dieses MIB-Objekt auf die Liste der PHYs fest, die für die Verwendung über die aktuelle BSS-Netzwerkverbindung (Basic Service Set) aktiviert wurden. Weitere Informationen zum MIB-Objekt msDot11ActivePhyList finden Sie unter OID_DOT11_ACTIVE_PHY_LIST.
Der Wert von DOT11_PHY_ID_ANY. In diesem Fall kann die 802.11-Station einen beliebigen PHY aus der Liste der aktiven PHYs verwenden, die durch das MIB-Objekt msDot11ActivePhyList definiert werden.

Der Miniporttreiber muss die Sendeanforderung fehlschlagen, wenn die von uPhyId angegebene PHY entweder nicht unterstützt wird oder über einen proprietären Mechanismus deaktiviert wurde, der vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) implementiert wurde. In diesem Fall legt der Miniporttreiber den Status-Member der NET_BUFFER_LIST-Struktur auf NDIS_STATUS_UNSUPPORTED_MEDIA fest und ruft auf. NdisMSendNetBufferListsComplete, um die Sendeanforderung abzuschließen.

uDelayedSleepValue

Die Zeit in Mikrosekunden, bevor eine Antwort auf das Paket erwartet wird. Das uDelayedSleepValue-Element ist nur gültig, wenn alle der folgenden Werte zutreffen:

Bei dem Paket handelt es sich um ein MSDU-Paket (Media Access Control, Media Access Control).
Die Station 802.11 wird im Energiesparmodus (PS) betrieben. In dieser Situation verfügt das ExtSTA-Objekt msDot11PowerSavingLevel (Extensible Station) über einen beliebigen Wert außer DOT11_POWER_SAVING_NO_POWER_SAVING. Weitere Informationen zum MIB-Wert msDot11PowerSavingLevel finden Sie unter OID_DOT11_POWER_MGMT_REQUEST.

Die 802.11-Station verwendet den Wert von uDelayedSleepValue , um die Netzwerkleistung während des Betriebs im PS-Modus zu optimieren. Abhängig vom PS-Modus kann beispielsweise die 802.11-Station das Funkgerät nach der Übertragung des Pakets eingeschaltet lassen, wenn uDelayedSleepValue klein ist. Dadurch wird die Netzwerklatenz für den Empfang der Antwort reduziert.

pvMediaSpecificInfo

Ein Zeiger auf einen Puffer, der medienspezifische Informationen enthält. Dieser Member sollte NULL sein, wenn die 802.11 NET_BUFFER_LIST Struktur, der diese Struktur zugeordnet ist, aus dem nativen 802.11-Framework selbst stammt (einschließlich aller NET_BUFFER_LIST-Strukturen, die von einer IHV-Erweiterung stammen).

Andernfalls verweist pvMediaSpecificInfo auf die Out-of-Band-Daten (OOB), die dem Eintrag MediaSpecificInformation im NetBufferListInfo-Member der ursprünglichen 802.3-NET_BUFFER_LIST-Struktur zugeordnet sind. pvMediaSpecificInfo ermöglicht dem Miniporttreiber den Zugriff auf die medienspezifischen Informationen eines IHV-spezifischen 802.3-Protokolltreibers.

uSendFlags

Ein Satz von Flags, die Sendeattribute definieren. Derzeit sind keine Flags definiert. Dieser Member sollte 0 (null) sein.

Hinweise

Der Miniporttreiber führt einen Sendevorgang aus, wenn seine MiniportSendNetBufferLists wird aufgerufen. Jedes Paket, das über diese Funktion an den Treiber übergeben wird, wird durch eine NET_BUFFER_LIST-Struktur definiert, die native 802.11-Out-of-Band-Daten (OOB) enthält. Die OOB-Daten enthalten medienspezifische Parameter, die die 802.11-Station bei der Übertragung des Pakets verwendet.

Der Miniporttreiber greift über das Makro NET_BUFFER_LIST_INFO mit den folgenden Parametern auf die nativen 802.11-OOB-Daten zu:

Der _NBL-Parameter , der den Zeiger auf die NET_BUFFER_LIST-Struktur übergeben wird, die für das empfangene 802.11-Paket verwendet wird.
Der _ id-Parameter , der den ID-Wert von MediaSpecificInformation übergeben wird.

Weitere Informationen zu nativen 802.11-Sendevorgängen finden Sie unter Native 802.11-Sendevorgänge.

Anforderungen

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