estructura DOT11_BSS_ENTRY (windot11.h)

Importante La interfaz LAN inalámbrica Nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.
 
La estructura DOT11_BSS_ENTRY define una baliza IEEE 802.11 o marco de respuesta que la estación 802.11 recibió durante su última operación de examen.

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 DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO unión.

dot11BSSID

La dirección de 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 envió el marco de respuesta de sondeo o baliza 802.11 recibido por la estación 802.11 durante el análisis. 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 del indicador de intensidad de señal recibido (RSSI), en unidades de decibelios a los que se hace referencia a 1,0 miliwatts (dBm), según lo detectó 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 funciona dentro del dominio normativo, tal y 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 de 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 IE de país, establezca 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 cuando 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 cuadro de respuesta de baliza o sondeo recibido de esa red BSS. Si un IE solo está disponible en un fotograma, el controlador de minipuerto debe combinar el IE con las otras IE del último marco de respuesta de baliza o sondeo recibido.

Cuando la NIC está en el 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 minipuerto Native 802.11 almacena en caché los fotogramas 802.11 Beacon y Probe Response recibidos. Para obtener más información sobre la operación de examen, vea Native 802.11 Scan Operations.

Después de que la estación 802.11 complete la operación de examen, el controlador de minipuerto devuelve la lista de los fotogramas de baliza y respuesta de sondeo almacenados en caché cuando se consultan por OID_DOT11_ENUM_BSS_LIST. Se da formato a una estructura DOT11_BSS_ENTRY independiente para cada marco de baliza y respuesta de sondeo.

Requisitos

   
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Header windot11.h (incluye Ndis.h)

Consulte también

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST