DOT11_SCAN_REQUEST_V2-Struktur (windot11.h)
Die DOT11_SCAN_REQUEST_V2-Struktur definiert die Parameter für den expliziten Scanvorgang, der von der Station 802.11 ausgeführt wird. Die Station führt den expliziten Scanvorgang nach einer OID-Set-Anforderung von OID_DOT11_SCAN_REQUEST aus.
Syntax
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
Member
dot11BSSType
Der Typ der BSS-Netzwerke (Basic Service Set), für die die Station 802.11 überprüft wird. Der Datentyp für dieses Element ist die DOT11_BSS_TYPE-Enumeration .
dot11BSSID
Der BSS-Bezeichner (BSSID) eines BSS-Netzwerks, für das die 802.11-Station scannt. Wenn für dieses Element die BSSID (0xFFFFFFFFFFFF) festgelegt ist, sucht die Station nach allen BSSIDs.
dot11ScanType
Der Typ des Scans, den die 802.11-Station ausführt. Der Datentyp für dieses Element ist die DOT11_SCAN_TYPE-Enumeration, die die folgenden Werte deklariert:
dot11_scan_type_active
Die Station überträgt einen 802.11-Testanforderungsrahmen auf jedem Kanal, den sie scannt. Er befindet sich lange genug im Kanal, um 802.11 Testantwortframes für seine Testanforderung zu empfangen. Die Station empfängt auch 802.11 Beacon-Frames, die auf dem Kanal gesendet werden.
dot11_scan_type_passive
Die Station überträgt keinen 802.11-Testanforderungsframe auf jedem kanal, den sie scannt. Stattdessen empfängt es 802.11 Beacon- oder Probe Request-Frames, die auf dem Kanal gesendet werden.
dot11_scan_type_auto
Die Station kann aktive oder passive Scans durchführen oder eine Kombination aus beiden Scantypen verwenden.
Unabhängig vom Wert von dot11ScanType muss die 802.11-Station einen Scantyp von dot11_scan_type_passive ausführen, wenn sie Kanäle scannt, die in der aktuellen Regulatorischen Domäne nicht gültig sind. Außerdem muss die 802.11-Station einen Scantyp von dot11_scan_type_passive ausführen, wenn sie keine standardmäßige regulatorische Domäne aufweist. Weitere Informationen zu regulatorischen Domänen finden Sie unter OID_DOT11_CURRENT_REG_DOMAIN.
Wenn das dot11_scan_type_forced Bit im dot11ScanType-Member festgelegt ist, muss die 802.11-Station einen vollständigen Scan für jeden unterstützten Kanal durchführen. Wenn das dot11_scan_type_forced Bit nicht festgelegt ist, kann die 802.11-Station einen vollständigen Scan durchführen oder eine teilweise Überprüfung für eine Teilmenge der unterstützten Kanäle durchführen.
bRestrictedScan
Wenn dieser Member TRUE ist, führt die 802.11-Station eine Überprüfung durch, die auf den Kanal und die PHY-Konfiguration beschränkt ist, die zum Herstellen einer Verbindung mit einem BSS-Netzwerk verwendet wird.
Der Miniporttreiber muss diesen Member ignorieren, wenn einer der folgenden Punkte zutrifft:
- Der Miniporttreiber arbeitet im ExtSTA-Modus.
- Die Station 802.11 ist nicht mit einem BSS-Netzwerk verbunden.
udot11SSIDsOffset
Der Offset im ucBuffer-Array , in dem die Liste des Dienstsatzbezeichners (Service Set Identifier, SSID) beginnt. Jeder Eintrag in der SSID-Liste ist als DOT11_SSID-Struktur formatiert.
Die Station 802.11 sucht nach jeder SSID in der Liste. Wenn z. B. dot11ScanType auf dot11_scan_type_active festgelegt ist, überträgt die Station 802.11 beim Scannen auf einem Kanal eine 802.11-Testanforderung für jede SSID in der Liste.
uNumOfdot11SSIDs
Die Anzahl der Einträge in der SSID-Liste.
Wenn uNumOfdot11SSIDs 0 ist, muss der Miniporttreiber eine SSID-Liste verwenden, die die SSID des Feldhalters mit der Länge null enthält.
bUseRequestIE
Wenn dieser Member TRUE ist, muss die 802.11-Station die Liste der Anforderungs-IDs (definiert durch die Member uRequestIDsOffset und uNumOfRequestIDs ) innerhalb des Anforderungsinformationselements 802.11d jedes Testanforderungsframes enthalten, den er während der aktiven Überprüfung überträgt.
Der Miniporttreiber muss diesen Member (zusammen mit den Membern uRequestIDsOffset und uNumOfRequestIDs ) ignorieren, wenn einer der folgenden Elemente zutrifft:
- Der Miniporttreiber arbeitet im ExtSTA-Modus.
- Das 802.11 dot11MultiDomainCapabilityEnabled Management Information Base (MIB)-Objekt ist FALSE. Weitere Informationen zum DOT11MultiDomainCapabilityEnabled-MIB-Objekt finden Sie unter OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- Das dot11ScanType-Element ist auf dot11_scan_type_passive festgelegt.
uRequestIDsOffset
Der Offset im ucBuffer-Array , in dem die Liste Anforderungs-IDs beginnt. Jeder Eintrag in der Anforderungs-IDs-Liste ist als UCHAR-Datentyp formatiert.
uNumOfRequestIDs
Die Anzahl der Einträge in der Anforderungs-IDs-Liste.
uPhyTypeInfosOffset
Der Offset im ucBuffer-Array , in dem die Liste der PHY-Typen beginnt. Jeder Eintrag in der Liste der PHY-Typen ist als DOT11_PHY_TYPE_INFO-Struktur formatiert.
Die Station 802.11 muss den BSS-Scan mithilfe der angegebenen PHY-Typen aus dieser Liste durchführen.
Der Miniporttreiber muss diesen Member (zusammen mit dem Element uNumOfPhyTypeInfos ) ignorieren, wenn bRestrictedScan auf TRUE festgelegt ist.
uNumOfPhyTypeInfos
Die Anzahl der Einträge in der Liste der PHY-Typen.
Wenn uNumOfPhyTypeInfos null ist, führt die 802.11-Station den Scan mit allen unterstützten PHYs durch.
uIEsOffset
Der Offset im ucBuffer-Array , in dem die Liste der Informationselemente mit variabler Länge beginnt. Die Station 802.11 muss die Liste der IEs an das Ende jedes Testanforderungsrahmens anfügen, den sie während einer aktiven Überprüfung überträgt.
Der Miniporttreiber muss diesen Member (zusammen mit dem uIEsLength-Element ) ignorieren, wenn dot11ScanType auf dot11_scan_type_passive festgelegt ist.
uIEsLength
Die Länge der Liste der IEs in Bytes.
ucBuffer[1]
Der Puffer, der optionale Daten enthält, wie über andere Member dieser Struktur angegeben.
Hinweise
Die Station 802.11 führt explizite Scanvorgänge nach der OID-Set-Anforderung von OID_DOT11_SCAN_REQUEST aus. Die Station führt den Scanvorgang mithilfe der parameter aus, die über die DOT11_SCAN_REQUEST_V2 definiert sind, die die Setanforderung begleitet.
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) |