Compartilhar via


OID_WDI_TASK_DOT11_RESET (dot11wificxintf.h)

Importante

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

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

Objeto Compatível com interrupçã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 dot11 reset, o driver WDI para de emitir novos comandos para o componente IHV e interrompe qualquer tarefa em andamento na porta. Ele também libera suas filas Rx e TX.

A redefinição dot11 combina a semântica da primitiva de redefinição 802.11 MLME e PLME. Quando o componente IHV recebe uma solicitação de redefinição dot11, ele deve executar as seguintes tarefas.

  • Redefina a entidade MAC da porta para o estado inicial.
  • Redefina os atributos MIB da porta para que eles sejam definidos com seus valores padrão, se bSetDefaultMIB for True.
  • Redefina as máquinas de estado TX/Rx para a entidade PHY e defina para o estado Rx somente para garantir que nenhum outro quadro seja transmitido.
  • Libere a fila Rx da placa e conclua o envio para cada pacote nas filas TX.
  • Se o parâmetro MAC address 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 a dissociação aos pares antes da redefinição. Dessa maneira, o componente IHV não precisa repetir esse processo.

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 de dot11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X O endereço MAC que deve ser usado para a porta.
WDI_TLV_CONFIGURED_MLO_LINK_MAC_ADDRESS X Uma matriz de endereço MAC de link do tipo MLO (Multi-Link Operation).

Indicação de conclusão de tarefa

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11
Servidor mínimo com suporte Windows Server 2022
Cabeçalho dot11wificxintf.h