estructura DOT11_AUTH_CIPHER_PAIR_LIST (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_AUTH_CIPHER_PAIR_LIST define una lista de estructuras de DOT11_AUTH_CIPHER_PAIR.

Sintaxis

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

Miembros

Header

Tipo, revisión y tamaño de la estructura DOT11_AUTH_CIPHER_PAIR_LIST. 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 DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1.

Tamaño

Este miembro debe establecerse en sizeof(DOT11_AUTH_CIPHER_PAIR_LIST).

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

uNumOfEntries

Número de entradas de la matriz AuthCipherPairs.

uTotalNumOfEntries

El número máximo de entradas que puede contener la matriz de AuthCipherPairs.

AuthCipherPairs[1]

Lista de estructuras de DOT11_AUTH_CIPHER_PAIR.

Observaciones

Un controlador de miniport devuelve la estructura de DOT11_AUTH_CIPHER_PAIR_LIST cuando se consulta mediante cualquiera de las dos OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR o OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Cuando se consultan estos OID, el controlador de miniport debe comprobar que el InformationBuffer miembro del MiniportOidRequest función OidRequest parámetro es lo suficientemente grande como para devolver toda la estructura de DOT11_AUTH_CIPHER_PAIR_LIST, incluidas todas las entradas de la matriz AuthCipherPairs. El valor del miembro InformationBufferLength del parámetro OidRequest determina lo que debe hacer el controlador de miniport, como se muestra en la lista siguiente:

• Si el valor del miembro informationBufferLength es menor que la longitud, en bytes, de toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST, el controlador de miniport debe hacer lo siguiente:
  • Para el parámetro OidRequest, establezca el miembro BytesWritten en cero y el miembro BytesNeeded longitud, en bytes, de toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST.
  • Produzca un error en la solicitud de consulta devolviendo NDIS_STATUS_BUFFER_OVERFLOW de su función MiniportOidRequest.
• Si el valor de la InformationBufferLength miembro es mayor o igual que la longitud, en bytes, de toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST, el controlador de miniport debe hacer lo siguiente para completar una solicitud de consulta correcta:
  • Para la estructura de DOT11_AUTH_CIPHER_PAIR_LIST, establezca el de uNumOfEntries y uTotalNumOfEntries en el número total de entradas de la matriz AuthCipherPairs.
  • Para el parámetro OidRequest, establezca el miembro BytesNeeded en cero y el miembro BytesWritten longitud, en bytes, de toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST. El controlador de minipuerto también debe copiar toda la estructura de DOT11_AUTH_CIPHER_PAIR_LIST en el miembro InformationBuffer.
  • Devuelve NDIS_STATUS_SUCCESS de su función de MiniportOidRequest.

A partir de Windows 7, un controlador de miniporte 802.11 puede notificar cualquier combinación de pares de algoritmos de cifrado y autenticación admitidos en DOT11_AUTH_CIPHER_PAIR_LIST. Sin embargo, si el sistema operativo inicia Soft AP, solo habilita el algoritmo de autenticación DOT11_AUTH_ALGO_RSNA_PSK y el algoritmo de cifrado DOT11_CIPHER_ALGO_CCMP. Para admitir Soft AP, el controlador de miniport debe admitir este par de autenticación y cifrado.

Si WPS está habilitado en una NIC que funciona en modo AP extensible, el controlador de miniporte debe permitir que las estaciones del mismo nivel se asocien a la API extensible mediante Open System Authentication o algoritmos de privacidad equivalente cableada (WEP), independientemente de los algoritmos de autorización y cifrado habilitados. Para obtener más información sobre WPS y EXTENSIBLE AP, vea OID_DOT11_WPS_ENABLED.

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)

Consulte también

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER