struttura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

La struttura DOT11_EXTSTA_SEND_CONTEXT definisce gli attributi Native 802.11 di un pacchetto da inviare dal driver miniport che opera in modalità Extensible Station (ExtSTA). Per altre informazioni su questa modalità operativa, vedere Extensible Station Operation Mode.For more information about this operation mode, see Extensible Station Operation Mode.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura DOT11_EXTSTA_SEND_CONTEXT. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare i membri di Header sui valori seguenti:

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_EXTSTA_SEND_CONTEXT_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_EXTSTA_SEND_CONTEXT).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

usExemptionActionType

Tipo di esenzione della crittografia per il pacchetto. Sono definiti i tipi di esenzione seguenti:

DOT11_EXEMPT_NO_EXEMPTION

Il pacchetto non è esente da alcuna operazione di crittografia eseguita dalla stazione 802.11.

DOT11_EXEMPT_ALWAYS

Il pacchetto è esente da qualsiasi operazione di crittografia eseguita dalla stazione 802.11. La stazione 802.11 deve trasmettere il pacchetto non crittografato.

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

Il pacchetto è esente da qualsiasi operazione di crittografia eseguita dalla stazione 802.11 solo se la stazione non dispone di una chiave di mapping delle chiavi per l'indirizzo MAC (Destination Media Access Control) del pacchetto. Per altre informazioni sulle chiavi di mapping delle chiavi, vedere 802.11 Tipi di chiave di crittografia.

uPhyId

Identificatore (ID) di un tipo PHY nella stazione 802.11. La stazione 802.11 deve utilizzare il PHY specificato per trasmettere il pacchetto.

Il valore di uPhyId deve essere uno dei seguenti:

Valore di una voce nell'elenco di tipi PHY attivi definiti dall'oggetto MIB msDot11ActivePhyList . Il driver miniport imposta questo oggetto MIB sull'elenco di PHY che sono stati attivati per l'uso sulla connessione di rete del set di servizi di base (BSS) corrente. Per altre informazioni sull'oggetto MIB msDot11ActivePhyList , vedere OID_DOT11_ACTIVE_PHY_LIST.
Il valore di DOT11_PHY_ID_ANY, nel qual caso la stazione 802.11 può utilizzare qualsiasi PHY dall'elenco di PHY attivi definiti dall'oggetto MIB msDot11ActivePhyList .

Il driver miniport deve non riuscire la richiesta di invio se il PHY specificato da uPhyId non è supportato o è stato disabilitato tramite un meccanismo proprietario implementato dal fornitore hardware indipendente (IHV). In questo caso, il driver miniport imposta il membro Status della struttura NET_BUFFER_LIST su NDIS_STATUS_UNSUPPORTED_MEDIA e chiamate NdisMSendNetBufferListsComplete per completare la richiesta di invio.

uDelayedSleepValue

Tempo, in microsecondi, prima che sia prevista una risposta al pacchetto. Il membro uDelayedSleepValue è valido solo se sono soddisfatte tutte le condizioni seguenti:

Il pacchetto è un pacchetto MSDU (Media Access Control).
La stazione 802.11 funziona in modalità risparmio energia (PS). In questo caso, l'oggetto Extensible Station (ExtSTA) msDot11PowerSavingLevel Management Information Base (MIB) ha qualsiasi valore tranne DOT11_POWER_SAVING_NO_POWER_SAVING. Per altre informazioni sul valore MIB msDot11PowerSavingLevel , vedere OID_DOT11_POWER_MGMT_REQUEST.

La stazione 802.11 usa il valore di uDelayedSleepValue per ottimizzare le prestazioni di rete durante il funzionamento in modalità PS. Ad esempio, a seconda della modalità PS, la stazione 802.11 potrebbe mantenere la radio attivata dopo la trasmissione del pacchetto se uDelayedSleepValue è piccolo. In questo modo, la latenza di rete verrà ridotta per la ricezione della risposta.

pvMediaSpecificInfo

Puntatore a un buffer che contiene informazioni specifiche del supporto. Questo membro deve essere NULL quando la struttura 802.11 NET_BUFFER_LIST associata a questa struttura proviene dal framework nativo 802.11 stesso (incluse le strutture NET_BUFFER_LIST provenienti da un'estensione IHV).

In caso contrario , pvMediaSpecificInfo punta ai dati fuori banda (OOB) associati alla voce MediaSpecificInformation nel membro NetBufferListInfo della struttura di NET_BUFFER_LIST originale 802.3. pvMediaSpecificInfo consente al driver miniport di accedere alle informazioni specifiche del supporto da un driver di protocollo 802.3 specifico di IHV.

uSendFlags

Set di flag che definiscono gli attributi di invio. Attualmente non sono definiti flag. Questo membro deve essere zero.

Commenti

Il driver miniport esegue un'operazione di invio quando Viene chiamato MiniportSendNetBufferLists . Ogni pacchetto passato al driver tramite questa funzione è definito da una struttura di NET_BUFFER_LIST , che contiene dati nativi 802.11 fuori banda (OOB). I dati OOB contengono parametri specifici del supporto utilizzati dalla stazione 802.11 durante la trasmissione del pacchetto.

Il driver miniport accede ai dati OOB nativi 802.11 tramite la macro NET_BUFFER_LIST_INFO con i parametri seguenti:

Parametro _NBL , che viene passato il puntatore alla struttura NET_BUFFER_LIST utilizzata per il pacchetto 802.11 ricevuto.
Parametro _ id , che viene passato il valore dell'identificatore (ID) di MediaSpecificInformation.

Per altre informazioni sulle operazioni di invio native 802.11, vedere Operazioni di invio native 802.11.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	windot11.h (include Ndis.h)