estructura DOT11_BSS_ENTRY (windot11.h)
Sintaxis
typedef struct DOT11_BSS_ENTRY {
ULONG uPhyId;
DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_BSS_TYPE dot11BSSType;
LONG lRSSI;
ULONG uLinkQuality;
BOOLEAN bInRegDomain;
USHORT usBeaconPeriod;
ULONGLONG ullTimestamp;
ULONGLONG ullHostTimestamp;
USHORT usCapabilityInformation;
ULONG uBufferLength;
UCHAR ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;
Miembros
uPhyId
Identificador (ID) del PHY que la estación 802.11 usó para detectar la red BSS. PHY ID es el índice de la lista de PHY admitidos devueltos por el controlador a través de una consulta de OID_DOT11_SUPPORTED_PHY_TYPES.
Este identificador no debe ser DOT11_PHY_ID_ANY.
PhySpecificInfo
Atributos del PHY al que hace referencia el miembro uPhyId . PhySpecificInfo tiene el formato de DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO unión.
dot11BSSID
Dirección del control de acceso multimedia (MAC) del punto de acceso (AP) (para redes BSS de infraestructura) o estación del mismo nivel (para redes BSS independientes) que enviaron el marco 802.11 Beacon o Probe Response recibido por la estación 802.11 mientras se examina. El tipo de datos de este miembro es la estructura DOT11_MAC_ADDRESS .
dot11BSSType
Tipo de red BSS.
El tipo de datos de este miembro es la enumeración DOT11_BSS_TYPE . El controlador de minipuerto no debe establecer este miembro en el valor de dot11_BSS_type_any .
lRSSI
El valor de indicador de intensidad de señal recibido (RSSI), en unidades de decibelios a los que se hace referencia a 1,0 miliwatts (dBm), como detecta la estación 802.11 para la estación AP o del mismo nivel.
uLinkQuality
Valor de calidad del vínculo comprendido entre 0 y 100. Un valor de 100 especifica la calidad de vínculo más alta. Para obtener más información sobre cómo determinar la calidad del vínculo, consulte Operaciones de calidad de vínculo.
bInRegDomain
Este miembro especifica si la estación ap o del mismo nivel está funcionando dentro del dominio normativo, tal como se identifica en la cadena de país de entrada. Para establecer este miembro, el controlador de minipuerto debe usar las siguientes directrices:
- Si la estación 802.11 no admite varios dominios normativos, establezca el miembro en TRUE. Para obtener más información sobre varios dominios normativos, consulte OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
- Si la cadena de país de entrada es ceros, establezca el miembro en TRUE.
- Si la estación ap o del mismo nivel no funciona en un canal válido para el dominio normativo especificado por la cadena de país de entrada, establezca el miembro en FALSE.
-
Si el marco 802.11 Beacon o Probe Response, que se recibió de la estación AP o del mismo nivel, no incluye un elemento de información de país (IE), establezca el miembro en TRUE.
Para obtener más información sobre el IE de país, consulte la cláusula 7.3.2.12 del estándar IEEE 802.11d-2001.
- Si el marco 802.11 Beacon o Probe Response, que se recibió de la estación AP o del mismo nivel, incluye un country IE, establece el miembro en FALSE si el valor del subcampo Cadena de país no es igual a la cadena de país de entrada.
- Establezca el miembro en TRUE en todos los demás casos.
usBeaconPeriod
Valor del campo Intervalo de baliza del marco 802.11 Beacon o Probe Response.
ullTimestamp
Valor del campo Marca de tiempo del marco 802.11 Beacon o Probe Response.
ullHostTimestamp
La marca de tiempo, resuelta a través de una llamada a NdisGetCurrentSystemTime, que registra cuándo la estación 802.11 recibió el marco 802.11 Beacon o Probe Response.
usCapabilityInformation
Valor del campo Información de funcionalidad del marco 802.11 Beacon o Probe Response.
uBufferLength
Longitud, en bytes, de la matriz ucBuffer en la estructura DOT11_BSS_ENTRY. ulBufferLength debe ser la longitud exacta de los datos de la matriz ucBuffer y no debe contener ningún relleno para la alineación.
ucBuffer[1]
Los elementos de información de longitud variable (IE) de los marcos 802.11 Beacon o Probe Response. Para cada BSS, las IEs deben ser del último marco de respuesta de baliza o sondeo recibido de esa red BSS. Si un IE solo está disponible en un marco, el controlador de minipuerto debe combinar el IE con las otras IE del último marco de baliza o respuesta de sondeo recibido.
Cuando la NIC está en modo op de punto de acceso extensible (ExtAP), la lista BSS debe contener una entrada para el BSS que creó la NIC.
Para obtener más información sobre los campos de los marcos ieee 802.11 Beacon o Probe Response, consulte la cláusula 8.4 del estándar IEEE 802.11-2012.
Comentarios
Cuando la estación 802.11 realiza una operación de examen, el controlador de miniporte Nativo 802.11 almacena en caché los fotogramas de baliza y respuesta de sondeo recibidos 802.11. Para obtener más información sobre la operación de examen, consulte Operaciones de examen nativas 802.11.
Después de que la estación 802.11 complete la operación de examen, el controlador de miniporte devuelve la lista de los marcos de baliza y respuesta de sondeo almacenados en caché cuando OID_DOT11_ENUM_BSS_LIST consulta. Se da formato a una estructura de DOT11_BSS_ENTRY independiente para cada marco de baliza y respuesta de sondeo.
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) |