estrutura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Artigo
08/08/2023

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.

A estrutura DOT11_EXTSTA_SEND_CONTEXT define os atributos Native 802.11 de um pacote a ser enviado pelo driver de miniporta 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 de estação extensível.

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 miniporta deve definir os membros de 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 é 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 802.11 Tipos de chave de criptografia.

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

O driver de miniporta deverá 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 IHV (fornecedor independente de hardware). Nessa situação, o driver de miniporto define o membro Status da estrutura NET_BUFFER_LIST como NDIS_STATUS_UNSUPPORTED_MEDIA e chama 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 itens a seguir são verdadeiros:

O pacote é um pacote MSDU (unidade de dados de serviço) do MAC (controle de acesso à mídia).
A estação 802.11 está operando em um modo de economia de energia (PS). Nessa situação, o objeto MIB (Extensible Station) msDot11PowerSavingLevel tem qualquer valor, exceto DOT11_POWER_SAVING_NO_POWER_SAVING. Para obter mais informações sobre o valor MIB msDot11PowerSavingLevel , 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 pode 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 nativa 802.11 (incluindo quaisquer estruturas NET_BUFFER_LIST provenientes de uma extensão IHV).

Caso contrário, pvMediaSpecificInfo aponta para os dados OOB (fora de banda) 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.

Comentários

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

O driver de miniporta 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 de 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
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)