estrutura DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.
 
A estrutura DOT11_SUPPORTED_ANTENNA_LIST especifica uma lista de antenas que podem ser usadas para operações de recebimento ou transmissão.

Sintaxe

typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
  ULONG                   uNumOfEntries;
  ULONG                   uTotalNumOfEntries;
  DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;

Membros

uNumOfEntries

O número de entradas na matriz dot11SupportedAntenna . Um valor zero para o membro uNumOfEntries indica uma lista vazia.

uTotalNumOfEntries

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

dot11SupportedAntenna[1]

A lista de antenas com suporte. Cada elemento nesta lista é formatado como um DOT11_SUPPORTED_ANTENNA estrutura.

Comentários

Um driver de miniporte retorna a estrutura DOT11_SUPPORTED_ANTENNA_LIST quando consultado por qualquer um OID_DOT11_SUPPORTED_RX_ANTENNA ou OID_DOT11_SUPPORTED_TX_ANTENNA.

Quando esses OIDs são consultados, o driver de miniporto deve verificar se o membro InformationBuffer do parâmetro OidRequest da função MiniportOidRequest é grande o suficiente para retornar toda a estrutura DOT11_SUPPORTED_ANTENNA_LIST, incluindo todas as entradas na matriz dot11SupportedAntenna. O valor do membro InformationBufferLength 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_SUPPORTED_ANTENNA_LIST, o driver de miniporte deverá fazer o seguinte:
    • Defina o membro uNumOfEntries como zero.
    • Defina o membro uTotalNumOfEntries como o número de entradas na matriz dot11SupportedAntenna .

      Para o parâmetro OidRequest , defina o membro BytesWritten como zero e o membro BytesNeeded para o comprimento, em bytes, de toda a estrutura DOT11_PHY_ID_LIST.

    • Falha na solicitação de consulta retornando NDIS_STATUS_BUFFER_OVERFLOW de sua função MiniportOidRequest .
  • Se o valor do membro InformationBufferLength for maior ou igual ao comprimento, em bytes, de toda a estrutura DOT11_SUPPORTED_ANTENNA_LIST, o driver de miniporto deverá fazer o seguinte para concluir uma solicitação de consulta bem-sucedida:
    • Para a estrutura DOT11_SUPPORTED_ANTENNA_LIST, defina os membros uNumOfEntries e uTotalNumOfEntries como o número total de entradas na matriz dot11SupportedAntenna .
    • Para o parâmetro OidRequest , defina o membro BytesNeeded como zero e o membro BytesWritten para o comprimento, em bytes, de toda a estrutura DOT11_SUPPORTED_ANTENNA_LIST. O driver de miniporto também deve copiar toda a estrutura de DOT11_SUPPORTED_ANTENNA_LIST para o membro InformationBuffer .
    • Retorne NDIS_STATUS_SUCCESS de sua função MiniportOidRequest .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho windot11.h (inclua Ndis.h)

Confira também

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA