estructura DOT11_EXTSTA_ATTRIBUTES (windot11.h)
Importante
WiFiCx es el nuevo modelo de controlador de Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes. El modelo de controlador WDI ahora está en modo de mantenimiento y solo recibirá correcciones de prioridad alta.
La estructura DOT11_EXTSTA_ATTRIBUTES define los atributos físicos y operativos del controlador de miniporte y la estación 802.11 al operar 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 el formato de una estructura NDIS_OBJECT_HEADER.
El controlador de miniport debe establecer los miembros de Encabezado 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 se va a ejecutar el controlador:
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.
Tamaño
Este miembro debe establecerse en sizeof(DOT11_EXTSTA_ATTRIBUTES).
Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.
uScanSSIDListSize
Número máximo de identificadores de 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 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 conjuntos 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 de la lista de direcciones MAC excluidas admitida por la estación 802.11. La estación 802.11 debe admitir una lista de direcciones MAC excluida con al menos cuatro entradas.
Para obtener más información sobre la lista de direcciones MAC excluidas deseada, consulte OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.
uPrivacyExemptionListSize
Número máximo de entradas en la lista de exención 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 la clave predeterminada y las tablas de claves predeterminadas 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. Para 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 en pares (PMKID) compatible con la estación 802.11.
Si la estación 802.11 no admite una memoria caché PMKID, el controlador de miniport 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, consulte Per-Station claves predeterminadas.
bStrictlyOrderedServiceClassImplemented
Valor booleano que, si se establece en TRUE, especifica que la estación 802.11 admite la clase de servicio IEEE 802.11 StrictlyOrdered 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 StrictlyOrdered, 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 del modo seguro de la combinación de controladores NIC/miniport. El sistema operativo interpreta este miembro de forma diferente según el 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 de operación 802.11. 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 miniporte implementa el modo seguro de operación 802.11.
- Si el campo de bits se establece 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.
uNumSupportedCountryOrRegionStrings
Número de cadenas de país o región admitidas por 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 país o cadena de 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 estructura DOT11_COUNTRY_OR_REGION_STRING.
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 se configura para su funcionamiento en una red de conjunto de servicios básico de infraestructura (BSS). El miembro uInfraNumSupportedUcastAlgoPairs debe ser el número de estructuras de DOT11_AUTH_CIPHER_PAIR de la matriz a las que hace referencia el miembro pInfraSupportedUcastAlgoPairs.
pInfraSupportedUcastAlgoPairs
Puntero a una matriz de algoritmos de autenticación y cifrado admitidos por 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 estructura DOT11_AUTH_CIPHER_PAIR.
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 se configura 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 las 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 estructura DOT11_AUTH_CIPHER_PAIR.
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 se configura 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 las 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 estructura DOT11_AUTH_CIPHER_PAIR.
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 las 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 estructura DOT11_AUTH_CIPHER_PAIR.
bAutoPowerSaveMode
La funcionalidad de compatibilidad de la combinación de controladores NIC/miniport para administrar de forma autónoma el pozo de energía, incluida la detección y negociación del modo de ahorro de energía (PSM) Wi-Fi adecuado entre el dispositivo y el punto de acceso Wi-Fi. Los controladores de miniporte compatibles con NDIS 6.30 Wi-Fi deben establecer este miembro en TRUE.
uMaxNetworkOffloadListSize
El número máximo de redes que puede descargar un controlador de miniporte, 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. Se establece 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 en pInfraSupportedMcastMgmtAlgoPairs.
pInfraSupportedMcastMgmtAlgoPairs
Puntero a una matriz de pares de algoritmos de autenticación y cifrado que admite el dispositivo para MFP en modo de infraestructura. El cifrado recomendado para Windows 8 es BIP con autenticación WPA o WPA2. Cada entrada de la matriz tiene el formato de estructura DOT11_AUTH_CIPHER_PAIR.
bNeighborReportSupported
bAPChannelReportSupported
bActionFramesSupported
bANQPQueryOffloadSupported
bHESSIDConnectionSupported
Observaciones
El 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 miniporta llama a NdisMSetMiniportAttributes, el controlador establece el parámetro MiniportAttributes a la dirección de un bloque de memoria asignado por el controlador que contiene una estructura 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 miniportar 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 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 MFPR está establecido por un punto de acceso 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 8 y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | windot11.h (incluye Ndis.h) |
Consulte también
modo de operación de estación extensible
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST DOT11_COUNTRY_OR_REGION_STRING OID_DOT11_PRIVACY_EXEMPTION_LIST OID_DOT11_CIPHER_KEY_MAPPING_KEYPer-Station de claves predeterminadas
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES