DOT11_SUPPORTED_ANTENNA_LIST Struktur (windot11.h)

  • Artikel
Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.
 
Die DOT11_SUPPORTED_ANTENNA_LIST-Struktur gibt eine Liste von Antennen an, die für Empfangs- oder Sendevorgänge verwendet werden können.

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)

Weitere Informationen

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA