Compartilhar via


OID_WDI_TASK_DOT11_RESET

Importante

Este tópico faz parte do modelo de driver WDI lançado no Windows 10. O modelo de driver WDI está no modo de manutenção e receberá apenas correções de alta prioridade. WiFiCx é o modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

OID_WDI_TASK_DOT11_RESET solicita que o componente IHV redefina o estado MAC e PHY em uma porta especificada.

Objeto Anulação com capacidade Prioridade padrão (política de driver de host) Tempo de execução normal (segundos)
Porta Não 1 1

Antes de emitir um comando de redefinição do dot11, o driver WDI interrompe a emissão de novos comandos para o componente IHV e anula qualquer tarefa em andamento na porta. Ele também libera suas filas Rx e TX.

A redefinição do dot11 combina a semântica do primitivo de redefinição de 802,11 MLME e PLME. Quando o componente IHV recebe uma solicitação de redefinição do dot11, ele deve executar as tarefas a seguir.

  • Redefina a entidade MAC da porta para seu estado inicial.
  • Redefina os atributos MIB da porta para que eles sejam definidos como seus valores padrão, se bSetDefaultMIB for true.
  • Redefina os computadores de estado TX/Rx para a entidade PHY e defina-os como estado Rx apenas para garantir que não sejam transmitidos mais quadros.
  • Libere a fila Rx do adaptador e conclua o envio de cada pacote nas filas TX.
  • Se o parâmetro de endereço MAC estiver presente, redefina o endereço MAC da porta para o valor especificado.
  • Defina o estado da porta como INIT antes de concluir a operação de redefinição do dot11.

Se a porta que está sendo redefinida estivesse operando como um STA, AP ou um Wi-Fi Direct Client ou GO, o host teria disparado a tarefa de desconexão para solicitar que o componente IHV enviasse desassociação aos pares antes da redefinição. Dessa forma, o componente IHV não precisa fazer isso novamente.

Parâmetros de tarefa

TLV Várias instâncias TLV permitidas Opcional Descrição
WDI_TLV_DOT11_RESET_PARAMETERS Parâmetros para a redefinição do dot11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X O endereço MAC que deve ser usado para a porta.

Indicação de conclusão da tarefa

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Requisitos

Cliente mínimo com suporte

Windows 10

Servidor mínimo com suporte

Windows Server 2016

Cabeçalho

Dot11wdi.h