estrutura DOT11_EXTSTA_SEND_CONTEXT (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_EXTSTA_SEND_CONTEXT define os atributos Native 802.11 de um pacote a ser enviado pelo driver de miniporto que opera no modo ExtSTA (Estação Extensível). Para obter mais informações sobre esse modo de operação, consulte modo de operação extensível da estação.

Sintaxe

typedef struct DOT11_EXTSTA_SEND_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  USHORT             usExemptionActionType;
  ULONG              uPhyId;
  ULONG              uDelayedSleepValue;
  PVOID              pvMediaSpecificInfo;
  ULONG              uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;

Membros

Header

O tipo, a revisão e o tamanho da estrutura DOT11_EXTSTA_SEND_CONTEXT. 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_EXTSTA_SEND_CONTEXT_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_EXTSTA_SEND_CONTEXT).

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

usExemptionActionType

O tipo de isenção de criptografia para o pacote. Os seguintes tipos de isenção são definidos:

DOT11_EXEMPT_NO_EXEMPTION

O pacote não está isento de nenhuma operação de criptografia executada pela estação 802.11.

DOT11_EXEMPT_ALWAYS

O pacote é isento de quaisquer operações de criptografia executadas pela estação 802.11. A estação 802.11 deve transmitir o pacote não criptografado.

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

O pacote será isento de quaisquer operações de criptografia executadas pela estação 802.11 somente se a estação não tiver uma chave de mapeamento de chave para o endereço MAC (controle de acesso à mídia de destino) do pacote. Para obter mais informações sobre chaves de mapeamento de chave, consulte tipos de chave de criptografia 802.11.

uPhyId

O identificador (ID) de um tipo PHY na estação 802.11. A estação 802.11 deve usar o PHY especificado para transmitir o pacote.

O valor de uPhyId deve ser um dos seguintes:

O valor de uma entrada na lista de tipos PHY ativos definidos pelo objeto msDot11ActivePhyList MIB. O driver de miniporto define esse objeto MIB como a lista de PHYs que foram ativados para uso na conexão de rede do BSS (conjunto de serviços básico) atual. Para obter mais informações sobre o objeto msDot11ActivePhyList MIB, consulte OID_DOT11_ACTIVE_PHY_LIST.
O valor de DOT11_PHY_ID_ANY, nesse caso, a estação 802.11 pode usar qualquer PHY na lista de PHYs ativos definidos pelo objeto msDot11ActivePhyList MIB.

O driver de miniporto deve falhar na solicitação de envio se o PHY especificado por uPhyId não tiver suporte ou tiver sido desabilitado por meio de um mecanismo proprietário implementado pelo fornecedor de hardware independente (IHV). Nessa situação, o driver de miniporto define o Status membro da estrutura NET_BUFFER_LIST para NDIS_STATUS_UNSUPPORTED_MEDIA e chamadas NdisMSendNetBufferListsComplete para concluir a solicitação de envio.

uDelayedSleepValue

O tempo, em microssegundos, antes que uma resposta ao pacote seja esperada. O membro uDelayedSleepValue só é válido quando todos os seguintes são verdadeiros:

O pacote é um pacote de MSDU (unidade de dados de serviço) de controle de acesso de mídia (MAC).
A estação 802.11 está operando em um modo de PS (economia de energia). Nessa situação, a Estação Extensível (ExtSTA) objeto msDot11PowerSavingLevel base de informações de gerenciamento (MIB) tem qualquer valor, exceto DOT11_POWER_SAVING_NO_POWER_SAVING. Para obter mais informações sobre o msDot11PowerSavingLevel valor MIB, consulte OID_DOT11_POWER_MGMT_REQUEST.

A estação 802.11 usa o valor de uDelayedSleepValue para otimizar o desempenho da rede enquanto opera em um modo PS. Por exemplo, dependendo do modo PS, a estação 802.11 poderá manter o rádio ativado após a transmissão do pacote se uDelayedSleepValue for pequeno. Ao fazer isso, a latência de rede será reduzida para receber a resposta.

pvMediaSpecificInfo

Um ponteiro para um buffer que contém informações específicas da mídia. Esse membro deve ser NULL quando a estrutura 802.11 NET_BUFFER_LIST à qual essa estrutura está associada vem da própria estrutura 802.11 nativa (incluindo quaisquer estruturas de NET_BUFFER_LIST provenientes de uma extensão IHV).

Caso contrário, pvMediaSpecificInfo aponta para os dados fora de banda (OOB) associados à entrada MediaSpecificInformation no membro NetBufferListInfo da estrutura de NET_BUFFER_LIST 802.3 original. pvMediaSpecificInfo permite que o driver de miniporto acesse as informações específicas da mídia de um driver de protocolo 802.3 específico do IHV.

uSendFlags

Um conjunto de sinalizadores que definem atributos de envio. Atualmente, não há sinalizadores definidos. Esse membro deve ser zero.

Observações

O driver de miniporto executa uma operação de envio quando ela miniportSendNetBufferLists é chamado. Cada pacote passado para o driver por meio dessa função é definido por uma estrutura de NET_BUFFER_LIST, que contém dados OOB (Nativos 802.11 fora de banda). Os dados do OOB contêm parâmetros específicos de mídia que a estação 802.11 usa ao transmitir o pacote.

O driver de miniporto acessa os dados OOB nativos 802.11 por meio da macro NET_BUFFER_LIST_INFO com os seguintes parâmetros:

O parâmetro _NBL, que é passado o ponteiro para a estrutura de NET_BUFFER_LIST usada para o pacote 802.11 recebido.
O parâmetro _id, que é passado o valor do identificador (ID) de MediaSpecificInformation.

Para obter mais informações sobre operações de envio nativas 802.11, consulte operações de envio nativas 802.11.

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)