DOT11_PHY_ID_LIST Struktur (windot11.h)

Artikel
02/27/2024

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_PHY_ID_LIST-Struktur gibt eine Liste mit null oder mehr PHY-Typen an.

Syntax

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

Member

Header

Der Typ, die Revision und die Größe der DOT11_PHY_ID_LIST-Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieser Member muss auf DOT11_PHY_ID_LIST_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_PHY_ID_LIST) festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uNumOfEntries

Die Anzahl der Einträge im Array dot11PhyId .

uTotalNumOfEntries

Die maximale Anzahl von Einträgen, die das dot11PhyId-Array enthalten kann.

dot11PhyId[1]

Die Liste der PHY-Bezeichner (IDs).

Hinweise

Eine PHY-ID im dot11PhyId-Array muss eine der folgenden sein:

Ein Index in der Tabelle der unterstützten PHYs, die vom nativen 802.11 Operational msDot11SupportedPhyTypes-Verwaltungsinformationsbasisobjekt (MIB) definiert werden. Weitere Informationen zu PHY-IDs und dem MIB-Objekt msDot11SupportedPhyTypes finden Sie unter OID_DOT11_SUPPORTED_PHY_TYPES.
Eine PHY-ID mit dem Wert DOT11_PHY_ID_ANY. Diese PHY-ID wird als Einplatzhalter-PHY-ID bezeichnet und wird verwendet, um alle unterstützten PHY auf der 802.11-Station anzugeben. Wenn die Werthalter-PHY-ID verwendet wird, muss dies der einzige Eintrag im Array dot11PhyId sein.

Ein Miniporttreiber gibt die DOT11_PHY_ID_LIST-Struktur zurück, wenn er von OID_DOT11_ACTIVE_PHY_LIST oder OID_DOT11_DESIRED_PHY_LIST abgefragt wird.

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_PHY_ID_LIST-Struktur zurückzugeben, einschließlich aller Einträge im dot11PhyId-Array. 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_PHY_ID_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen:
- Legen Sie den uNumOfEntries-Member auf Null fest.
- Legen Sie den uTotalNumOfEntries-Member auf die Anzahl der Einträge im Array dot11PhyId 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_PHY_ID_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_PHY_ID_LIST-Struktur die Elemente uNumOfEntries und uTotalNumOfEntries auf die Gesamtzahl der Einträge im Array dot11PhyId fest.
- Legen Sie für den OidRequest-Parameter den BytesNeed-Member auf Null und den BytesWritten-Member auf die Länge der gesamten DOT11_PHY_ID_LIST-Struktur in Bytes fest. Der Miniporttreiber muss auch die gesamte DOT11_PHY_ID_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)