Compartir a través de

OID_WDI_TASK_DOT11_RESET (dot11wificxintf.h)

  • Artículo

Importante

Este tema forma parte del modelo de controlador en WiFiCx. WiFiCx es el modelo de controlador Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes. El modelo de controlador Wi-Fi anterior WDI está en modo de mantenimiento y solo recibirá correcciones de alta prioridad.

OID_WDI_TASK_DOT11_RESET solicita que el componente IHV restablezca el estado MAC y PHY en un puerto especificado.

Object Anulación compatible Prioridad predeterminada (directiva de controlador de host) Ejecución normal (segundos)
Port No 1 1

Antes de emitir un comando dot11 reset, el controlador WDI deja de emitir nuevos comandos al componente IHV y anula cualquier tarea en curso en el puerto. También vacía sus colas Rx y TX.

El restablecimiento dot11 combina la semántica del primitivo de restablecimiento 802.11 MLME y PLME. Cuando el componente IHV recibe una solicitud de restablecimiento de dot11, debe realizar las siguientes tareas.

  • Restablecer la entidad MAC del puerto a su estado inicial.
  • Restablecer los atributos MIB del puerto para que se establezcan en sus valores predeterminados, si bSetDefaultMIB es true.
  • Restablecer las máquinas de estado TX/Rx para la entidad PHY y establecerlas en estado Rx solo para asegurarse de que no se transmiten más marcos.
  • Vaciar la cola de Rx del adaptador y completar el envío de cada paquete de las colas TX.
  • Si el parámetro de dirección MAC está presente, restablecer la dirección MAC del puerto al valor especificado.
  • Establecer el estado del puerto en INIT antes de completar la operación de restablecimiento de dot11.

Si el puerto que se restablece funcionaba como STA, AP o un cliente de Wi-Fi Direct o GO, el host habría desencadenado la tarea de desconexión para solicitar al componente de IHV que envíe la desasociación a los elementos del mismo nivel antes del restablecimiento. Por lo tanto, el componente IHV no necesita volver a hacerlo.

Parámetros de tareas

TLV Se permiten varias instancias de TLV Opcionales Descripción
WDI_TLV_DOT11_RESET_PARAMETERS Parámetros para el restablecimiento de dot11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X Dirección MAC que se debe usar para el puerto.
WDI_TLV_CONFIGURED_MLO_LINK_MAC_ADDRESS X Matriz de la dirección MAC de la operación multivínculo (MLO).

Indicación de finalización de tarea

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Requisitos

Requisito Valor
Cliente mínimo compatible Windows 11
Servidor mínimo compatible Windows Server 2022
Encabezado dot11wificxintf.h