estrutura DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)
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_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.
Observações
Um driver de miniporto 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 InformationBuffer membro do parâmetro OidRequestda 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 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 de DOT11_SUPPORTED_ANTENNA_LIST, o driver de miniporto deverá fazer o seguinte:
- Defina o membro uNumOfEntries como zero.
-
Defina o membro uTotalNumOfEntries com o número de entradas na matriz dot11SupportedAntenna.
Para o parâmetro OidRequest, defina o membro BytesWritten como zero e o membro BytesNeeded ao comprimento, em bytes, de toda a estrutura DOT11_PHY_ID_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 DOT11_SUPPORTED_ANTENNA_LIST, o driver de miniporto deverá fazer o seguinte para concluir uma solicitação de consulta bem-sucedida:
- Para a estrutura de DOT11_SUPPORTED_ANTENNA_LIST, defina o uNumOfEntries e membros uTotalNumOfEntries para o número total de entradas na matriz do dot11SupportedAntenna.
- Para o parâmetro OidRequest, defina o membro bytesNeeded como zero e o membro BytesWritten ao 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | windot11.h (inclua Ndis.h) |