estructura DOT11_CIPHER_ALGORITHM_LIST (windot11.h)

La estructura DOT11_CIPHER_ALGORITHM_LIST define una lista de estructuras de DOT11_CIPHER_ALGORITHM que se pueden habilitar en la estación 802.11.

Sintaxis

typedef struct DOT11_CIPHER_ALGORITHM_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;

Miembros

Header

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

Tamaño

Este miembro debe establecerse en sizeof(DOT11_CIPHER_ALGORITHM_LIST).

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

uNumOfEntries

Número de entradas de la matriz de AlgorithmIds.

uTotalNumOfEntries

Número máximo de entradas que puede contener el AlgorithmIds matriz.

AlgorithmIds[1]

Algoritmo de cifrado, definido por un DOT11_CIPHER_ALGORITHM valor de enumerador.

La lista de algoritmos de cifrado se ordena por preferencia. AlgorithmIds [0] define el algoritmo de cifrado con la preferencia más alta.

Observaciones

Un controlador miniport devuelve la estructura DOT11_CIPHER_ALGORITHM_LIST cuando se consulta mediante 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_CIPHER_ALGORITHM_LIST, incluidas todas las entradas de la matriz de AlgorithmIds. 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 de es menor que la longitud, en bytes, de toda la estructura DOT11_CIPHER_ALGORITHM_LIST, el controlador de miniport debe hacer lo siguiente:
  • Para el parámetro OidRequest, establezca el miembro bytes bytes escrito en cero y el miembro BytesNeededed a la longitud, en bytes, de toda la estructura DOT11_CIPHER_ALGORITHM_LIST.
  • Produzca un error en la solicitud de consulta devolviendo NDIS_STATUS_BUFFER_OVERFLOW de su función MiniportOidRequest.
• Si el valor del informationBufferLength miembro es mayor o igual que la longitud, en bytes, de toda la estructura DOT11_CIPHER_ALGORITHM_LIST, el controlador de miniport debe hacer lo siguiente para completar una solicitud de consulta correcta:
  • Para la estructura DOT11_CIPHER_ALGORITHM_LIST, establezca los uNumOfEntries y uTotalNumOfEntries miembros en el número total de entradas de la matriz AlgorithmIds de.
  • Para el parámetro OidRequest, establezca el miembro BytesNeededed en cero y el miembro BytesWritten longitud, en bytes, de toda la estructura DOT11_CIPHER_ALGORITHM_LIST. El controlador de minipuerto también debe copiar toda la estructura de DOT11_CIPHER_ALGORITHM_LIST en el miembro informationBuffer de.
  • Devuelve NDIS_STATUS_SUCCESS de su función de MiniportOidRequest.

Requisitos

Consulte también

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR

OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

NDIS_OBJECT_HEADER