DOT11_SUPPORTED_ANTENNA_LIST struttura (windot11.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless nativa 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_SUPPORTED_ANTENNA_LIST specifica un elenco di antenna che possono essere usate per le operazioni di ricezione o trasmissione.

Sintassi

typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
  ULONG                   uNumOfEntries;
  ULONG                   uTotalNumOfEntries;
  DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;

Members

uNumOfEntries

Numero di voci nella matrice dot11SupportedAntenna . Un valore zero per il membro uNumOfEntries indica un elenco vuoto.

uTotalNumOfEntries

Numero massimo di voci che la matrice dot11SupportedAntenna può contenere.

dot11SupportedAntenna[1]

Elenco delle antenne supportate. Ogni elemento di questo elenco viene formattato come elemento DOT11_SUPPORTED_ANTENNA struttura.

Commenti

Un driver miniport restituisce la struttura di DOT11_SUPPORTED_ANTENNA_LIST quando viene eseguita una query da uno dei due OID_DOT11_SUPPORTED_RX_ANTENNA o OID_DOT11_SUPPORTED_TX_ANTENNA.

Quando questi OID vengono sottoposti a query, il driver miniport deve verificare che il membro InformationBuffer del parametro OidRequest della funzione MiniportOidRequest sia abbastanza grande per restituire l'intera struttura DOT11_SUPPORTED_ANTENNA_LIST, incluse tutte le voci nella matrice dot11SupportedAntenna. Il valore del membro InformationBufferLength del parametro OidRequest determina le operazioni del driver miniport, come illustrato nell'elenco seguente:

Se il valore del membro InformationBufferLength è minore della lunghezza, in byte, dell'intera struttura DOT11_SUPPORTED_ANTENNA_LIST, il driver miniport deve eseguire le operazioni seguenti:
- Impostare il membro uNumOfEntries su zero.
- Impostare il membro uTotalNumOfEntries sul numero di voci nella matrice dot11SupportedAntenna .
  Per il parametro OidRequest impostare il membro BytesScritto su zero e il membro ByteNeeded sulla lunghezza, in byte, dell'intera struttura DOT11_PHY_ID_LIST.
- Eseguire l'errore della richiesta di query restituendo NDIS_STATUS_BUFFER_OVERFLOW dalla relativa funzione MiniportOidRequest .
Se il valore del membro InformationBufferLength è maggiore o uguale alla lunghezza, in byte, dell'intera struttura DOT11_SUPPORTED_ANTENNA_LIST, il driver miniport deve eseguire le operazioni seguenti per completare una richiesta di query riuscita:
- Per la struttura DOT11_SUPPORTED_ANTENNA_LIST, impostare i membri uNumOfEntries euTotalNumOfEntries sul numero totale di voci nella matrice dot11SupportedAntenna .
- Per il parametro OidRequest impostare il membro BytesNeeded su zero e il membro ByteScritto sulla lunghezza, in byte, dell'intera struttura DOT11_SUPPORTED_ANTENNA_LIST. Il driver miniport deve anche copiare l'intera struttura DOT11_SUPPORTED_ANTENNA_LIST nel membro InformationBuffer .
- Restituire NDIS_STATUS_SUCCESS dalla funzione MiniportOidRequest .

Requisiti

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

Vedi anche

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA

Condividi tramite