DOT11_PHY_TYPE_INFO Struktur (windot11.h)

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_TYPE_INFO-Struktur definiert Parameter, die die 802.11-Station zum Konfigurieren eines PHY beim Ausführen eines expliziten Scanvorgangs verwendet. Die Station führt den expliziten Scanvorgang nach einer festgelegten Anforderung von OID_DOT11_SCAN_REQUEST aus.

Syntax

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Member

dot11PhyType

Der Typ von PHY, den die 802.11-Station für den Scan verwendet. Der PHY-Typ wird durch die DOT11_PHY_TYPE-Enumeration definiert.

Hinweis Der Miniporttreiber muss diesen Member ignorieren, wenn er im ExtSTA-Modus (Extensible Station) ausgeführt wird.

bUseParameters

Wenn dieser Member TRUE ist, verwendet die Station 802.11 die anderen Member dieser Struktur, um den PHY für den Scanvorgang zu konfigurieren.

Wenn dieser Member FALSE ist, konfiguriert die 802.11-Station den PHY mithilfe eigener Einstellungen für den Scanvorgang.

Hinweis Wenn der Miniporttreiber im ExtSTA-Modus ausgeführt wird, legt das Betriebssystem diesen Member immer auf FALSE fest.

uProbeDelay

Die Zeitspanne in Mikrosekunden, die die 802.11-Station warten muss, bevor während der aktiven Überprüfung ein 802.11-Testanforderungsrahmen übertragen wird.

uMinChannelTime

Die minimale Zeit in 802,11 Zeiteinheiten (TU), die die 802.11-Station für jeden Kanal beim Scannen aufwendet. Eine TU beträgt 1024 Mikrosekunden.

Dieser Member muss größer oder gleich uProbeDelay sein.

uMaxChannelTime

Die maximale Zeitmenge in 802,11 Zeiteinheiten (TU), die die 802.11-Station für jeden Kanal beim Scannen aufwendet.

Dieser Member muss größer oder gleich uProbeDelay sein.

ChDescriptionType

Dieses Element gibt die Methode an, die verwendet wird, um die Einträge im ucChannelListBuffer-Array zu interpretieren. Der Datentyp für dieses Element ist die CH_DESCRIPTION_TYPE-Enumeration, die die folgenden Werte deklariert:

ch_description_type_logical

Der Kanaleintrag wird durch eine logische Kanalnummer definiert, die dem IEEE 802.11-Standard entspricht.

ch_description_type_center_frequency

Der Kanaleintrag wird in Einheiten von Megahertz (MHz) durch eine Kanalzentrfrequenz definiert.

uChannelListSize

Die Länge des ucChannelListBuffer-Arrays in Bytes. Jeder Eintrag in diesem Array ist als ULONG-Datentyp formatiert.

ucChannelListBuffer[1]

Ein Array, das Kanalbeschreibungen für den PHY-Typ enthält, der im dot11PhyType-Element angegeben ist.

Hinweise

Die DOT11_SCAN_REQUEST_V2-Struktur , die eine festgelegte Anforderung von OID_DOT11_SCAN_REQUEST begleitet, enthält ein Array von null oder mehr DOT11_PHY_TYPE_INFO Einträgen.

Weitere Informationen zu den Scanvorgängen, die von einem Native 802.11-Miniporttreiber ausgeführt werden, finden Sie unter Native 802.11-Scanvorgänge.

Weitere Informationen zum ExtSTA-Betriebsmodus finden Sie unter Betriebsmodus für extensible Station.

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_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST