struttura DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)
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_SUPPORTED_ANTENNA_LIST specifica un elenco di antenne che possono essere utilizzate per 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;
Membri
uNumOfEntries
Numero di voci nella matrice dot11SupportedAntenna. Un valore zero per il uNumOfEntries membro indica un elenco vuoto.
uTotalNumOfEntries
Numero massimo di voci che possono essere contenute nella matrice dot11SupportedAntenna.
dot11SupportedAntenna[1]
Elenco delle antenne supportate. Ogni elemento di questo elenco è formattato come DOT11_SUPPORTED_ANTENNA struttura.
Osservazioni
Un driver miniport restituisce la struttura DOT11_SUPPORTED_ANTENNA_LIST quando viene eseguita una query in uno dei due OID_DOT11_SUPPORTED_RX_ANTENNA o OID_DOT11_SUPPORTED_TX_ANTENNA.
Quando si eseguono query su questi ID, il driver miniport deve verificare che il membro del MiniportOidRe quest della funzione OidRequest parametro sia sufficientemente grande da restituire l'intera struttura DOT11_SUPPORTED_ANTENNA_LIST, incluse tutte le voci nella matrice dot11SupportedAntenna. Il valore del InformationBufferLength membro del parametro OidRequest determina cosa deve fare il driver miniport, come illustrato nell'elenco seguente:
-
Se il valore del membro InformationBufferLength di è minore della lunghezza, espressa in byte, dell'intera struttura DOT11_SUPPORTED_ANTENNA_LIST, il driver miniport deve eseguire le operazioni seguenti:
- Impostare il uNumOfEntries membro su zero.
-
Impostare il membro uTotalNumOfEntries sul numero di voci nella matrice dot11SupportedAntenna.
Per il parametro OidRequest, impostare il membro BytesWritten su zero e il membro BytesNeededed sulla lunghezza, in byte, dell'intera struttura DOT11_PHY_ID_LIST.
- Interrompere la richiesta di query restituendo NDIS_STATUS_BUFFER_OVERFLOW dalla relativa funzione MiniportOidRequest.
-
Se il valore del membro InformationBufferLength di è 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 il uNumOfEntries e uTotalNumOfEntries membri 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.
- Restituisce NDIS_STATUS_SUCCESS dalla funzione miniportOidRequest corrispondente.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| intestazione | windot11.h (include Ndis.h) |