estrutura DOT11_EXTSTA_SEND_CONTEXT (windot11.h)
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 .
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.
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.
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) |