estructura DOT11_SCAN_REQUEST_V2 (windot11.h)
La estructura DOT11_SCAN_REQUEST_V2 define los parámetros de la operación de examen explícita realizada por la estación 802.11. La estación realiza la operación de examen explícita después de una solicitud de conjunto de OID de OID_DOT11_SCAN_REQUEST.
Sintaxis
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;
Miembros
dot11BSSType
Tipo de redes de conjunto de servicios básicos (BSS) para las que examina la estación 802.11. El tipo de datos de este miembro es la enumeración DOT11_BSS_TYPE .
dot11BSSID
Identificador BSS (BSSID) de una red BSS para la que examina la estación 802.11. Si este miembro se establece en el BSSID comodín (0xFFFFFFFFFFFF), la estación busca todos los BSSID.
dot11ScanType
Tipo de examen que realiza la estación 802.11. El tipo de datos de este miembro es la enumeración DOT11_SCAN_TYPE, que declara los siguientes valores:
dot11_scan_type_active
La estación transmite un marco de solicitud de sondeo 802.11 en cada canal que examina. Se encuentra en el canal lo suficientemente largo como para recibir 802.11 fotogramas de respuesta de sondeo para su solicitud de sondeo. La estación también recibe 802.11 marcos de baliza enviados en el canal.
dot11_scan_type_passive
La estación no transmite un marco de solicitud de sondeo 802.11 en cada canal que examina. En su lugar, recibe los fotogramas 802.11 Beacon o Probe Request enviados en el canal.
dot11_scan_type_auto
La estación puede realizar exámenes activos o pasivos, o puede usar una combinación de ambos tipos de examen.
Independientemente del valor de dot11ScanType, la estación 802.11 debe realizar un tipo de examen de dot11_scan_type_passive cada vez que examina en canales que no son válidos en el dominio normativo actual. Además, la estación 802.11 debe realizar un tipo de examen de dot11_scan_type_passive si no tiene un dominio normativo predeterminado. Para obtener más información sobre los dominios normativos, consulte OID_DOT11_CURRENT_REG_DOMAIN.
Si el bit de dot11_scan_type_forced se establece en el miembro dot11ScanType , la estación 802.11 debe realizar un examen completo en todos los canales admitidos. Si no se establece el bit de dot11_scan_type_forced , la estación 802.11 puede realizar un examen completo o puede realizar un examen parcial en un subconjunto de los canales admitidos.
bRestrictedScan
Si este miembro es TRUE, la estación 802.11 realiza un examen restringido al canal y la configuración PHY usada para conectarse a una red BSS.
El controlador de minipuerto debe omitir este miembro si se cumple alguna de las siguientes condiciones:
- El controlador de minipuerto funciona en modo ExtSTA.
- La estación 802.11 no está conectada a una red BSS.
udot11SSIDsOffset
Desplazamiento de la matriz ucBuffer donde comienza la lista de identificadores del conjunto de servicios (SSID). Cada entrada de la lista de SSID tiene el formato de estructura DOT11_SSID .
La estación 802.11 examina cada SSID de la lista. Por ejemplo, si dot11ScanType está establecido en dot11_scan_type_active, la estación 802.11 transmite una solicitud de sondeo 802.11 para cada SSID de la lista mientras examina en un canal.
uNumOfdot11SSIDs
Número de entradas de la lista SSID.
Si uNumOfdot11SSIDs es cero, el controlador de miniporte debe usar una lista de SSID que contenga el SSID de longitud cero comodín.
bUseRequestIE
Si este miembro es TRUE, la estación 802.11 debe incluir la lista de identificadores de solicitud (definidos a través de los miembros uRequestIDsOffset y uNumOfRequestIDs ) dentro del elemento de información de solicitud 802.11d (IE) de cada fotograma de solicitud de sondeo que transmite durante el examen activo.
El controlador de minipuerto debe omitir este miembro (junto con los miembros uRequestIDsOffset y uNumOfRequestIDs ) si se cumple alguna de las siguientes condiciones:
- El controlador de minipuerto funciona en modo ExtSTA.
- El objeto base de información de administración (MIB) 802.11 dot11MultiDomainCapabilityEnabled es FALSE. Para obtener más información sobre el objeto MIB dot11MultiDomainCapabilityEnabled , vea OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- El miembro dot11ScanType se establece en dot11_scan_type_passive.
uRequestIDsOffset
Desplazamiento de la matriz ucBuffer donde comienza la lista Identificadores de solicitud. Cada entrada de la lista de identificadores de solicitud tiene el formato de tipo de datos UCHAR.
uNumOfRequestIDs
Número de entradas de la lista de identificadores de solicitud.
uPhyTypeInfosOffset
Desplazamiento de la matriz ucBuffer donde comienza la lista de tipos PHY. Cada entrada de la lista de tipos PHY tiene el formato de estructura DOT11_PHY_TYPE_INFO .
La estación 802.11 debe realizar el examen BSS mediante cada uno de los tipos PHY especificados de esta lista.
El controlador de minipuerto debe omitir este miembro (junto con el miembro uNumOfPhyTypeInfos ) si bRestrictedScan está establecido en TRUE.
uNumOfPhyTypeInfos
Número de entradas de la lista de tipos PHY.
Si uNumOfPhyTypeInfos es cero, la estación 802.11 realiza el examen con todos sus PHY admitidos.
uIEsOffset
Desplazamiento de la matriz ucBuffer donde comienza la lista de elementos de información de longitud variable (IEs). La estación 802.11 debe anexar la lista de IE al final de cada marco de solicitud de sondeo que transmite durante un examen activo.
El controlador de minipuerto debe omitir este miembro (junto con el miembro uIEsLength ) si dot11ScanType está establecido en dot11_scan_type_passive.
uIEsLength
Longitud, en bytes, de la lista de IEs.
ucBuffer[1]
Búfer que contiene datos opcionales como se especifican a través de otros miembros de esta estructura.
Comentarios
La estación 802.11 realiza operaciones de examen explícitas después de la solicitud de conjunto de OID de OID_DOT11_SCAN_REQUEST. La estación realiza la operación de examen mediante los parámetros definidos a través de la DOT11_SCAN_REQUEST_V2, que acompaña a la solicitud establecida.
Para obtener más información sobre las operaciones de examen realizadas por un controlador de miniporte nativo 802.11, consulte Operaciones de examen nativas 802.11.
Para obtener más información sobre el modo de operación ExtSTA, vea Modo de operación de estación extensible.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Encabezado | windot11.h (incluye Ndis.h) |