struttura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Articolo
02/07/2025

Importante

WiFiCx è il nuovo modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti. Il modello di driver WDI è ora in modalità di manutenzione e riceverà solo correzioni ad alta priorità.

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.

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;

Membri

Header

Tipo, revisione e dimensione 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:

Digitare

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_EXTSTA_SEND_CONTEXT_REVISION_1.

Grandezza

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 dei tipi PHY attivi definiti dall'oggetto msDot11ActivePhyList oggetto MIB. Il driver miniport imposta questo oggetto MIB sull'elenco di PHY attivati per l'uso tramite la connessione di rete BSS (Basic Service Set) corrente. Per altre informazioni sull'oggetto msDot11ActivePhyList MIB, vedere OID_DOT11_ACTIVE_PHY_LIST.
Valore di DOT11_PHY_ID_ANY, nel qual caso la stazione 802.11 può utilizzare qualsiasi PHY dall'elenco di PHY attivi definiti dal msDot11ActivePhyList oggetto MIB.

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 chiama NdisMSendNetBufferListsComplete per completare la richiesta di invio.

uDelayedSleepValue

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

Il pacchetto è un pacchetto di unità dati del servizio MAC (Media Access Control).
La stazione 802.11 funziona in modalità risparmio energia (PS). In questo caso, l'oggetto Extensible Station (ExtSTA) msDot11PowerSavingLevel l'oggetto MIB (Management Information Base) ha qualsiasi valore tranne DOT11_POWER_SAVING_NO_POWER_SAVING. Per altre informazioni sul valore msDot11PowerSavingLevel MIB, 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 è piccola. In questo modo, la latenza di rete verrà ridotta per ricevere la risposta.

pvMediaSpecificInfo

Puntatore a un buffer che contiene informazioni specifiche del supporto. Questo membro deve essere null quando la struttura di NET_BUFFER_LIST 802.11 associata a questa struttura proviene dal framework nativo 802.11 stesso (incluse eventuali 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 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.

Osservazioni

Il driver miniport esegue un'operazione di invio quando viene chiamato il MiniportSendNetBufferLists. Ogni pacchetto passato al driver tramite questa funzione è definito da una struttura di NET_BUFFER_LIST, che contiene dati OOB (Native 802.11 out-of-band). I dati OOB contengono parametri specifici dei supporti 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 Native 802.11 Send Operations.