estrutura DOT11_CIPHER_ALGORITHM_LIST (windot11.h)

Artigo
02/07/2025

Importante

WiFiCx é o novo modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes. O modelo de driver WDI agora está no modo de manutenção e receberá apenas correções de alta prioridade.

A estrutura DOT11_CIPHER_ALGORITHM_LIST define uma lista de estruturas DOT11_CIPHER_ALGORITHM que podem ser habilitadas na estação 802.11.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura DOT11_CIPHER_ALGORITHM_LIST. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O driver de miniporto deve definir os membros do Header para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como DOT11_CIPHER_ALGORITHM_LIST_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_CIPHER_ALGORITHM_LIST).

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

uNumOfEntries

O número de entradas na matriz AlgorithmIds.

uTotalNumOfEntries

O número máximo de entradas que a AlgorithmIds matriz pode conter.

AlgorithmIds[1]

O algoritmo de criptografia, que é definido por um valor de enumerador DOT11_CIPHER_ALGORITHM.

A lista de algoritmos de criptografia é classificada por preferência. AlgorithmIds [0] define o algoritmo de criptografia com a preferência mais alta.

Observações

Um driver de miniporto retorna a estrutura DOT11_CIPHER_ALGORITHM_LIST quando ela é consultada por OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR ou OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Quando esses OIDs são consultados, o driver de miniporto deve verificar se o InformationBuffer membro do parâmetro da função MiniportOidRequest é grande o suficiente para retornar toda a estrutura DOT11_CIPHER_ALGORITHM_LIST, incluindo todas as entradas na matriz AlgorithmIds. O valor do InformationBufferLength membro do parâmetro OidRequest determina o que o driver de miniporto deve fazer, como mostra a lista a seguir:

Se o valor do membro InformationBufferLength for menor que o comprimento, em bytes, de toda a estrutura DOT11_CIPHER_ALGORITHM_LIST, o driver de miniporto deverá fazer o seguinte:
- Para o parâmetro OidRequest, defina o membro BytesWritten como zero e o membro BytesNeeded ao comprimento, em bytes, de toda a estrutura DOT11_CIPHER_ALGORITHM_LIST.
- Fail the query request by returning NDIS_STATUS_BUFFER_OVERFLOW from its MiniportOidRequest function.
Se o valor do membro InformationBufferLength for maior ou igual ao comprimento, em bytes, de toda a estrutura de DOT11_CIPHER_ALGORITHM_LIST, o driver de miniporto deverá fazer o seguinte para concluir uma solicitação de consulta bem-sucedida:
- Para a estrutura DOT11_CIPHER_ALGORITHM_LIST, defina o uNumOfEntries e membros uTotalNumOfEntries para o número total de entradas na matriz AlgorithmIds.
- Para o parâmetro OidRequest, defina o membro bytesNeeded como zero e o membro BytesWritten ao comprimento, em bytes, de toda a estrutura DOT11_CIPHER_ALGORITHM_LIST. O driver de miniporto também deve copiar toda a estrutura de DOT11_CIPHER_ALGORITHM_LIST para o membro InformationBuffer.
- Retorne NDIS_STATUS_SUCCESS de sua função MiniportOidRequest.