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_REQUESTaus.
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;
Angehörige
dot11BSSType
Der Typ der BSS-Netzwerke (Basic Service Set), für die die Station 802.11 scannt. Der Datentyp für dieses Element ist die DOT11_BSS_TYPE Enumeration.
dot11BSSID
Der BSS-Bezeichner (BSSID) eines BSS-Netzwerks, für das die Station 802.11 scannt. Wenn dieses Element auf die BSSID (0xFFFFFFFFFFFF) festgelegt ist, sucht die Station nach allen BSSIDs.
dot11ScanType
Der Typ des Scans, den die Station 802.11 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 Probeanforderungsrahmen auf jedem Kanal, den sie durchsucht. Er befindet sich lang genug auf dem Kanal, um 802.11 Probe Response Frames für seine Probeanforderung zu erhalten. 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 Probeanforderungsrahmen auf jedem Kanal, den sie durchsucht. Stattdessen empfängt es 802.11 Beacon- oder Probeanforderungsframes, 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 dot11ScanTypemuss die Station 802.11 einen Scantyp von dot11_scan_type_passive ausführen, wenn sie auf Kanäle überprüft wird, 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 nicht über eine standardmäßige behördliche Domäne verfügt. 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 auf jedem 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 sie kann einen Teilscan für eine Teilmenge der unterstützten Kanäle durchführen.
bRestrictedScan
Wenn dieses Mitglied TRUEist, führt die 802.11-Station einen Scan durch, der auf den Kanal und die PHY-Konfiguration beschränkt ist, die für die Verbindung mit einem BSS-Netzwerk verwendet wird.
Der Miniporttreiber muss dieses Element ignorieren, wenn einer der folgenden Werte zutrifft:
- Der Miniporttreiber wird im ExtSTA-Modus ausgeführt.
- Die Station 802.11 ist nicht mit einem BSS-Netzwerk verbunden.
udot11SSIDsOffset
Der Offset im ucBuffer Array, in dem die Dienstsatz-ID (SSID)-Liste 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_activefestgelegt ist, überträgt die 802.11-Station eine 802.11 Probeanforderung für jede SSID in der Liste während des Scannens auf einem Kanal.
uNumOfdot11SSIDs
Die Anzahl der Einträge in der SSID-Liste.
Wenn uNumOfdot11SSIDs null ist, muss der Miniporttreiber eine SSID-Liste verwenden, die die SSID mit der Länge der Wildcard null enthält.
bUseRequestIE
Wenn dieses Mitglied TRUEist, muss die Station 802.11 die Liste der Anforderungs-IDs (definiert durch die uRequestIDsOffset und uNumOfRequestIDs Member) innerhalb des 802.11d-Anforderungsinformationselements (IE) jedes Probeanforderungsframes enthalten, der während des aktiven Scans übertragen wird.
Der Miniporttreiber muss dieses Element ignorieren (zusammen mit dem uRequestIDsOffset und uNumOfRequestIDs Member), wenn einer der folgenden Elemente zutrifft:
- Der Miniporttreiber wird im ExtSTA-Modus ausgeführt.
- 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 Member ist auf dot11_scan_type_passivefestgelegt.
uRequestIDsOffset
Der Offset im ucBuffer Array, in dem die Anforderungs-IDs-Liste 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 mit jedem der angegebenen PHY-Typen aus dieser Liste durchführen.
Der Miniporttreiber muss dieses Element (zusammen mit dem uNumOfPhyTypeInfos Member) 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 (IEs) beginnt. Die Station 802.11 muss die Liste der IEs am Ende jedes Probeanforderungsrahmens anfügen, der während eines aktiven Scans übertragen wird.
Der Miniporttreiber muss dieses Element (zusammen mit dem uIEsLength Member) ignorieren, wenn dot11ScanType- auf dot11_scan_type_passivefestgelegt ist.
uIEsLength
Die Länge in Byte der Liste der IEs.
ucBuffer[1]
Der Puffer, der optionale Daten enthält, wie durch andere Member dieser Struktur angegeben.
Bemerkungen
Die 802.11-Station führt explizite Scanvorgänge nach der OID-Setanforderung von OID_DOT11_SCAN_REQUESTaus. Die Station führt den Scanvorgang mithilfe der parameter aus, die über die DOT11_SCAN_REQUEST_V2 definiert sind, die die set-Anforderung begleitet.
Weitere Informationen zu den Scanvorgängen eines nativen 802.11-Miniporttreibers finden Sie unter Native 802.11 Scan Operations.
Weitere Informationen zum ExtSTA-Betriebsmodus finden Sie unter Extensible Station Operation Mode.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | windot11.h (include Ndis.h) |