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 mantiene 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 siempre que examine en canales que no sean 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 dot11_scan_type_forced bit 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 a la configuración del canal y PHY que se usa para conectarse a una red BSS.
El controlador de miniport debe omitir este miembro si se cumple alguno de los siguientes elementos:
- El controlador miniport está funcionando 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 de conjunto de servicios (SSID). Cada entrada de la lista SSID tiene el formato de estructura DOT11_SSID.
La estación 802.11 examina cada SSID de la lista. Por ejemplo, si dot11ScanType se establece 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 miniport debe usar una lista 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 del uRequestIDsOffset y uNumOfRequestIDs miembros) 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 miniport debe omitir este miembro (junto con los miembros de uRequestIDsOffset y uNumOfRequestIDs) si alguno de los siguientes elementos es true:
- El controlador miniport está funcionando en modo ExtSTA.
- El objeto 802.11 dot11MultiDomainCapabilityEnabled management information base (MIB) es FALSE. Para obtener más información sobre el objeto dot11MultiDomainCapabilityEnabled MIB, vea OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- El miembro de dot11ScanType está establecido 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 un tipo de datos UCHAR.
uNumOfRequestIDs
Número de entradas de la lista de identificadores de solicitud.
uPhyTypeInfosOffset
Desplazamiento del 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 miniport 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 de ucBuffer donde comienza la lista de elementos de información de longitud variable (IE). La estación 802.11 debe anexar la lista de IE al final de cada fotograma de solicitud de sondeo que transmite durante un examen activo.
El controlador de miniport 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, tal como se especifica a través de otros miembros de esta estructura.
Observaciones
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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | windot11.h (incluye Ndis.h) |