Compartilhar via


OID_WDI_TASK_DOT11_RESET

Importante

Este tópico faz parte do modelo de driver WDI lançado em 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 em 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 Capacidade de anulação 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 dot11, o driver WDI para de emitir 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 dot11 combina a semântica do primitivo de redefinição de MLME e PLME 802,11. Quando o componente IHV recebe uma solicitação de redefinição 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 para 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 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 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