estructura DOT11_EXTSTA_ATTRIBUTES (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 dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
La estructura DOT11_EXTSTA_ATTRIBUTES define los atributos físicos y operativos del controlador de miniporte y la estación 802.11 cuando se opera en modo Estación extensible (ExtSTA). Para obtener más información sobre este modo de operación, vea Modo de operación de estación extensible.

Sintaxis

typedef struct DOT11_EXTSTA_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredBSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uExcludedMacAddressListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uKeyMappingTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  ULONG                           uPMKIDCacheSize;
  ULONG                           uMaxNumPerSTADefaultKeyTables;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  UCHAR                           ucSupportedQoSProtocolFlags;
  BOOLEAN                         bSafeModeImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
  ULONG                           uAdhocNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedUcastAlgoPairs;
  ULONG                           uAdhocNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedMcastAlgoPairs;
  BOOLEAN                         bAutoPowerSaveMode;
  ULONG                           uMaxNetworkOffloadListSize;
  BOOLEAN                         bMFPCapable;
  ULONG                           uInfraNumSupportedMcastMgmtAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;

Miembros

Header

Tipo, revisión y tamaño de la estructura DOT11_EXTSTA_ATTRIBUTES . Este miembro tiene formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer los miembros de Header en los valores siguientes.

Tipo

Este miembro debe establecerse en NDIS_OBJECT_TYPE_DEFAULT.

Revisión

Este miembro debe establecerse en uno de los siguientes valores según el sistema operativo en el que el controlador está pensado para ejecutarse:

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista con Service Pack 1 (SP1) o versiones posteriores de los sistemas operativos Windows

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8 o versiones posteriores de los sistemas operativos Windows

Estos valores determinan cómo interpreta el sistema operativo el miembro bSafeModeImplemented .

Size

Este miembro debe establecerse en sizeof(DOT11_EXTSTA_ATTRIBUTES).

Para obtener más información sobre estos miembros, consulte NDIS_OBJECT_HEADER.

uScanSSIDListSize

El número máximo de identificadores del conjunto de servicios (SSID) admitidos por la estación 802.11 para las operaciones de examen. La estación 802.11 debe admitir una lista de SSID de al menos cuatro entradas.

La lista de SSID que usa la estación 802.11 para el examen se especifica cuando se establece OID_DOT11_SCAN_REQUEST .

uDesiredBSSIDListSize

Número máximo de entradas de la lista deseada de identificadores de conjunto de servicios básicos (BSSID) compatibles con la estación 802.11. La estación 802.11 debe admitir una lista BSSID con al menos una entrada.

Para obtener más información sobre la lista de BSSID deseada, consulte OID_DOT11_DESIRED_BSSID_LIST.

uDesiredSSIDListSize

Número máximo de entradas en la lista de SSID deseada compatible con la estación 802.11. La estación 802.11 debe admitir una lista de SSID deseada con al menos una entrada.

Para obtener más información sobre la lista de SSID deseada, consulte OID_DOT11_DESIRED_SSID_LIST.

uExcludedMacAddressListSize

Número máximo de entradas en la lista de direcciones MAC excluidas compatible con la estación 802.11. La estación 802.11 debe admitir una lista de direcciones MAC excluidas con al menos cuatro entradas.

Para obtener más información sobre la lista de direcciones MAC excluidas deseadas, consulte OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.

uPrivacyExemptionListSize

El número máximo de entradas de la lista de exenciones de privacidad admitida por la estación 802.11. La estación 802.11 debe admitir una lista de exención de privacidad con al menos una entrada.

Para obtener más información sobre la lista de exenciones de privacidad, consulte OID_DOT11_PRIVACY_EXEMPTION_LIST.

uKeyMappingTableSize

Número máximo de claves de asignación de claves de cifrado compatibles con la estación 802.11. Se recomienda que la estación 802.11 admita al menos 32 claves de asignación de claves.

Para obtener más información sobre las claves de asignación de claves, consulte OID_DOT11_CIPHER_KEY_MAPPING_KEY.

uDefaultKeyTableSize

El número máximo de claves de cifrado que admite la estación 802.11 para las tablas de claves predeterminadas y por estación.

Para los algoritmos de cifrado estándar 802.11, la estación 802.11 debe admitir un tamaño de tabla de al menos cuatro claves de cifrado. En el caso de los algoritmos de cifrado desarrollados por el proveedor de hardware independiente (IHV), el tamaño de la tabla puede ser cuatro o superior.

uWEPKeyValueMaxLength

Longitud máxima, en bytes, de una clave de cifrado WEP compatible con la estación 802.11.

En la tabla siguiente se enumeran las longitudes de clave mínima y máxima, en bytes, para los distintos valores de cifrado WEP definidos a través de DOT11_CIPHER_ALGORITHM.

Cifrado WEP Longitud mínima de clave Longitud máxima de clave
DOT11_CIPHER_ALGO_WEP40 5 5
DOT11_CIPHER_ALGO_WEP104 13 13
DOT11_CIPHER_ALGO_WEP 13 Cualquier longitud admitida por la estación 802.11

uPMKIDCacheSize

Número máximo de entradas en la memoria caché del identificador de clave maestra emparejada (PMKID) compatible con la estación 802.11.

Si la estación 802.11 no admite una memoria caché PMKID, el controlador de miniporte debe establecer este miembro en cero. De lo contrario, la estación 802.11 debe admitir un tamaño de caché PMKID de al menos tres entradas.

Para obtener más información sobre la memoria caché PMKID, consulte OID_DOT11_PMKID_LIST.

uMaxNumPerSTADefaultKeyTables

Número máximo de tablas de claves de cifrado predeterminadas por estación compatibles con la estación 802.11. Se recomienda que la estación 802.11 admita al menos 32 tablas de claves de cifrado predeterminadas por estación.

Para obtener más información sobre las tablas de claves de cifrado predeterminadas por estación, vea Claves predeterminadas por estación.

bStrictlyOrderedServiceClassImplemented

Valor booleano que, si se establece en TRUE, especifica que la estación 802.11 admite la entrega de paquetes ieee 802.11 Estrictamente ordenada para la entrega de paquetes de unidad de datos de servicio de control de acceso multimedia (MAC).

Para obtener más información sobre la clase de servicio Estrictamente ordenada, consulte la cláusula 5.1.3 del estándar IEEE 802.11-2012.

ucSupportedQoSProtocolFlags

Conjunto de marcas que especifican la calidad de los protocolos de servicio (QoS) que implementa la NIC. Este miembro es cero o una combinación OR bit a bit de las marcas siguientes:

DOT11_QOS_PROTOCOL_FLAG_WMM

La NIC implementa el protocolo QoS 802.11 WMM.

DOT11_QOS_PROTOCOL_FLAG_11E

La NIC implementa el protocolo QoS 802.11e.

bSafeModeImplemented

La funcionalidad de compatibilidad con el modo seguro de la combinación de controladores NIC/miniport. El sistema operativo interpreta a este miembro de forma diferente en función del valor de Header.Revision:

Revisión = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

El sistema operativo interpreta el miembro bSafeModeImplemented como un valor booleano. Si este valor es TRUE, la NIC implementa el modo seguro 802.11 de operación. De lo contrario, el valor es FALSE.

Revisión = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 o superior

El sistema operativo interpreta el miembro bSafeModeImplemented como un campo de bits con los siguientes valores de bits posibles establecidos:

  • Si el campo de bits se establece en DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED sin ningún otro conjunto de bits, el controlador de minipuerto implementa el modo seguro de funcionamiento 802.11.
  • Si el campo de bits está establecido en DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, la combinación de NIC/miniport ha recibido un certificado de validación del Instituto Nacional de Estándares y Tecnología (NIST) en la Publicación Federal Information Processing Standards (FIPS) Publication 140-2, Security Requirements for Cryptographic Modules.
Este miembro se usa junto con OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

Número de cadenas de país o región compatibles con la estación 802.11. Si la estación 802.11 admite varios dominios normativos según lo especificado por el estándar IEEE 802.11d-2001, cada cadena de país o región identifica un dominio normativo admitido por la estación 802.11.

Si la estación 802.11 no admite el estándar IEEE 802.11d-2001, el controlador de miniport debe establecer uNumSupportedCountryOrRegionStrings en cero.

pSupportedCountryOrRegionStrings

Puntero a una matriz de cadenas de país o región 802.11d compatibles con la estación 802.11. Cada entrada de la matriz tiene el formato de DOT11_COUNTRY_OR_REGION_STRING estructura.

uInfraNumSupportedUcastAlgoPairs

El número de algoritmos de autenticación y cifrado admitidos por la estación 802.11 para enviar y recibir paquetes de unidifusión cuando está configurado para su funcionamiento en una red de conjunto de servicios básicos de infraestructura (BSS). El miembro uInfraNumSupportedUcastAlgoPairs debe ser el número de estructuras de DOT11_AUTH_CIPHER_PAIR de la matriz a la que hace referencia el miembro pInfraSupportedUcastAlgoPairs .

pInfraSupportedUcastAlgoPairs

Puntero a una matriz de algoritmos de autenticación y cifrado compatibles con la estación 802.11 para enviar y recibir paquetes de unidifusión en una red BSS de infraestructura. Cada entrada de la matriz tiene el formato de DOT11_AUTH_CIPHER_PAIR estructura.

uInfraNumSupportedMcastAlgoPairs

El número de algoritmos de autenticación y cifrado admitidos por la estación 802.11 para enviar y recibir paquetes de multidifusión y difusión cuando está configurado para su funcionamiento en una red de conjunto de servicios básicos de infraestructura (BSS). El miembro uInfraNumSupportedMcastAlgoPairs debe ser el número de estructuras de DOT11_AUTH_CIPHER_PAIR de la matriz a la que hace referencia el miembro pInfraSupportedMcastAlgoPairs .

pInfraSupportedMcastAlgoPairs

Puntero a una matriz de algoritmos de autenticación y cifrado compatibles con la estación 802.11 para enviar y recibir paquetes de multidifusión y difusión en una red BSS de infraestructura. Cada entrada de la matriz tiene el formato de DOT11_AUTH_CIPHER_PAIR estructura.

uAdhocNumSupportedUcastAlgoPairs

El número de algoritmos de autenticación y cifrado admitidos por la estación 802.11 para enviar y recibir paquetes de unidifusión cuando está configurado para su funcionamiento en una red BSS (IBSS) independiente. El miembro uAdhocNumSupportedUcastAlgoPairs debe ser el número de estructuras de DOT11_AUTH_CIPHER_PAIR de la matriz a la que hace referencia el miembro pAdhocSupportedUcastAlgoPairs .

pAdhocSupportedUcastAlgoPairs

Puntero a una matriz de algoritmos de autenticación y cifrado compatibles con la estación 802.11 para enviar y recibir paquetes de unidifusión en una red IBSS. Cada entrada de la matriz tiene el formato de DOT11_AUTH_CIPHER_PAIR estructura.

uAdhocNumSupportedMcastAlgoPairs

El número de algoritmos de autenticación y cifrado admitidos por la estación 802.11 para enviar y recibir paquetes de multidifusión y difusión cuando está configurado para su funcionamiento en una red IBSS. El miembro uAdhocNumSupportedMcastAlgoPairs debe ser el número de estructuras de DOT11_AUTH_CIPHER_PAIR de la matriz a la que hace referencia el miembro pAdhocSupportedMcastAlgoPairs .

pAdhocSupportedMcastAlgoPairs

Puntero a una matriz de algoritmos de autenticación y cifrado compatibles con la estación 802.11 para enviar y recibir paquetes de multidifusión y difusión en una red IBSS. Cada entrada de la matriz tiene el formato de DOT11_AUTH_CIPHER_PAIR estructura.

bAutoPowerSaveMode

La funcionalidad de compatibilidad de la combinación de controladores NIC/miniporte para administrar de forma autónoma el pozo de energía, incluida la detección y negociación del modo de ahorro de Wi-Fi energía (PSM) adecuado entre el dispositivo y el punto de acceso Wi-Fi. Los controladores de miniporte NDIS 6.30 compatibles Wi-Fi deben establecer este miembro en TRUE.

uMaxNetworkOffloadListSize

El número máximo de redes que puede descargar un controlador de minipuerto, si tiene la capacidad de admitir la funcionalidad De descarga de lista de redes.

bMFPCapable

La funcionalidad de compatibilidad del controlador NIC/miniport para combinar para admitir la protección de fotogramas de administración entre el dispositivo y el punto de acceso de Wi-Fi tal y como se especifica en la especificación 802.11w-2009. Establezca en TRUE si se admite. De lo contrario, este miembro debe establecerse en FALSE.

uInfraNumSupportedMcastMgmtAlgoPairs

Longitud de la matriz de pares de algoritmos de autenticación y cifrado a los que apunta pInfraSupportedMcastMgmtAlgoPairs.

pInfraSupportedMcastMgmtAlgoPairs

Puntero a una matriz de pares de algoritmos de autenticación y cifrado que el dispositivo admite para MFP en modo infra. El cifrado recomendado para Windows 8 es BIP con autenticación WPA o WPA2. Cada entrada de la matriz tiene el formato de DOT11_AUTH_CIPHER_PAIR estructura.

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

Comentarios

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES estructura contiene un miembro (pExtSTAAttributes) que especifica la dirección de una estructura de DOT11_EXTSTA_ATTRIBUTES. Cuando el controlador de miniporte llama a NdisMSetMiniportAttributes, el controlador establece el parámetro MiniportAttributes en la dirección de un bloque de memoria asignado por el controlador que contiene una estructura de NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES junto con la estructura DOT11_EXTSTA_ATTRIBUTES.

No se admite la aplicación de protección de fotogramas de administración requerida (MFPR) en Windows 8. Por lo tanto, los controladores de minipuerto nunca deben establecer este bit en las funcionalidades de RSN de RSN IE durante una solicitud de asociación. En el caso de la directiva, el punto de acceso puede anunciar MFPR, lo que permitirá asociar sta compatible con MFP. Los puntos de acceso que no admiten la funcionalidad MFP producirán un error en la asociación. Si un punto de acceso establece MFPR y STA no es compatible con MFP, Windows 8 tratará la red como no coincidente en la funcionalidad y no enviará una solicitud de asociación al miniport.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 8 y versiones posteriores de los sistemas operativos Windows.
Encabezado windot11.h (incluye Ndis.h)

Consulte también

Modo de operación de estación extensible

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

Claves predeterminadas por estación

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST