DOT11_SUPPORTED_ANTENNA_LIST Struktur (windot11.h)
Syntax
typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;
Member
uNumOfEntries
Die Anzahl der Einträge im Array dot11SupportedAntenna . Ein Nullwert für das uNumOfEntries-Element gibt eine leere Liste an.
uTotalNumOfEntries
Die maximale Anzahl von Einträgen, die das dot11SupportedAntenna-Array enthalten kann.
dot11SupportedAntenna[1]
Die Liste der unterstützten Antennen. Jedes Element in dieser Liste ist als DOT11_SUPPORTED_ANTENNA Struktur.
Hinweise
Ein Miniporttreiber gibt die DOT11_SUPPORTED_ANTENNA_LIST-Struktur zurück, wenn er von einem der beiden Abfragen abgefragt wird. OID_DOT11_SUPPORTED_RX_ANTENNA oder OID_DOT11_SUPPORTED_TX_ANTENNA.
Wenn diese OIDs abgefragt werden, muss der Miniporttreiber überprüfen, ob der InformationBuffer-Member des OidRequest-Parameters der MiniportOidRequest-Funktion groß genug ist, um die gesamte DOT11_SUPPORTED_ANTENNA_LIST-Struktur zurückzugeben, einschließlich aller Einträge im Array dot11SupportedAntenna. Der Wert des InformationBufferLength-Members des OidRequest-Parameters bestimmt, was der Miniporttreiber tun muss, wie die folgende Liste zeigt:
-
Wenn der Wert des InformationBufferLength-Members kleiner als die Länge (in Bytes) der gesamten DOT11_SUPPORTED_ANTENNA_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen:
- Legen Sie den uNumOfEntries-Member auf Null fest.
-
Legen Sie das Element uTotalNumOfEntries auf die Anzahl der Einträge im Array dot11SupportedAntenna fest.
Legen Sie für den OidRequest-Parameter das BytesWritten-Element auf Null und das BytesNeed-Element auf die Länge der gesamten DOT11_PHY_ID_LIST-Struktur in Bytes fest.
- Führen Sie einen Fehler für die Abfrageanforderung durch Zurückgeben NDIS_STATUS_BUFFER_OVERFLOW aus der MiniportOidRequest-Funktion aus.
-
Wenn der Wert des InformationBufferLength-Members größer oder gleich der Länge (in Bytes) der gesamten DOT11_SUPPORTED_ANTENNA_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_SUPPORTED_ANTENNA_LIST-Struktur die Elemente uNumOfEntries und uTotalNumOfEntries auf die Gesamtzahl der Einträge im Array dot11SupportedAntenna fest.
- Legen Sie für den OidRequest-Parameter den BytesNeed-Member auf Null und den BytesWritten-Member auf die Länge der gesamten DOT11_SUPPORTED_ANTENNA_LIST-Struktur in Bytes fest. Der Miniporttreiber muss auch die gesamte DOT11_SUPPORTED_ANTENNA_LIST-Struktur in das InformationBuffer-Element kopieren.
- Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest-Funktion zurück.
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) |