DOT11_EXTSTA_SEND_CONTEXT-Struktur (windot11.h)
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.
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.
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.
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) |