OID_WDI_TASK_SCAN

Importante

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

OID_WDI_TASK_SCAN solicita una encuesta de redes BSS. El puerto realiza un examen según los requisitos de la especificación IEEE 802.11.

Object	Abort capable (Anular capaz de anular)	Prioridad predeterminada (directiva de controlador de host)	Tiempo de ejecución normal (segundos)
Port	Sí. El puerto debe estar en un estado limpio después de la anulación.	6 (examen en segundo plano) 5 (examen iniciado por el usuario)	4

Se indica un mensaje de inicio de tarea que contiene un WDI_TLV_STATUS una vez que el puerto ha iniciado el examen y está listo para recibir otros comandos.

Una vez que liveUpdatesNeeded habilita un examen, el puerto debe proporcionar actualizaciones incrementales (mediante indicaciones no solicitadas de NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST) sobre las entradas de BSS detectadas. El puerto no debe notificar las entradas de BSS detectadas anteriormente, pero que no se encontraron en el examen actual. Por motivos de potencia y rendimiento, el puerto debe limitar las indicaciones y enviar actualizaciones al host solo cuando haya descubierto 3 o más, o cuando haya detectado menos de 3 entradas, pero no las haya notificado al host durante más de 500 milisegundos. Una vez completado el examen, si el adaptador no administra entradas BSS, no es necesario recordar las entradas de BSS detectadas. Una vez finalizada la operación de examen, el puerto debe enviar la notificación de tarea completa al sistema operativo y dejar de notificar las entradas de BSS al host. El comando scan se usa para buscar redes heredadas (no Wi-Fi Direct) y el puerto no debe incluir las Wi-Fi IEs directas en las solicitudes de sondeo.

Si el adaptador no administra entradas BSS, el host recuerda las entradas BSS notificadas por el puerto desde un examen durante un período de tiempo finito. Agota el tiempo de espera de sus entradas almacenadas en caché y las vacía. Si el adaptador administra las entradas de BSS, almacena en caché y los agota el tiempo de espera. El host puede enviar el comando OID_WDI_SET_FLUSH_BSS_ENTRY para vaciar explícitamente las entradas.

El host realiza un seguimiento de las entradas de BSS mediante su BSSID. Si el puerto notifica dos entradas BSS para el mismo BSSID, el host sobrescribe uno con otro.

Mientras el examen está en curso, el puerto debe mantener las conexiones existentes (por ejemplo, Infraestructura o Wi-Fi Direct). Si ya existen conexiones, el puerto debe examinar un subconjunto de canales a la vez y entre subconjuntos, proporcionar a las demás conexiones acceso al medio. Durante el examen, el host puede enviar solicitudes de envío de paquetes a cualquier puerto del adaptador.

En las entradas BSS indicadas, el puerto puede incluir información de contexto específica del dispositivo. Esta información de contexto se devuelve al dispositivo si se pide al puerto que se conecte a esa entrada de BSS. Sin embargo, el host puede borrar este contexto automáticamente si se vacía la entrada BSS.

Se puede anular el comando scan. Al recibir el comando abort, el puerto debe dejar de intentar encontrar nuevas redes BSS y completar la tarea de examen lo antes posible. Cuando se ha completado la tarea (normalmente o debido a una anulación), el puerto debe estar en buen estado para que se pueda emitir otro examen en ese puerto.

El adaptador no debe infringir las restricciones reglamentarias al realizar un examen.

Parámetros de tareas

TLV	Se permiten varias instancias de TLV	Opcional	Descripción
WDI_TLV_BSSID			BSSID de la red que se va a buscar. Si se trata de la dirección MAC de difusión, la estación examina todos los BSSID.
WDI_TLV_SSID	X		Lista de SSID que debe buscar el puerto. Puede haber varios SSID en esta lista y uno de ellos puede ser un carácter comodín. Al realizar un examen activo en un canal, el puerto debe enviar una solicitud de sondeo para cada SSID de la lista. Si esta lista está vacía, el puerto debe buscar todos los SSID.
WDI_TLV_VENDOR_SPECIFIC_IE		x	Una o varias E/S que deben incluirse en las solicitudes de sondeo enviadas por el puerto. Estas IEs no se usan para el examen pasivo.
WDI_TLV_SCAN_MODE			Parámetros del modo de examen.
WDI_TLV_SCAN_DWELL_TIME			Parámetros de tiempo de permanencia.
WDI_TLV_BAND_CHANNEL	x	x	Lista de canales recomendados que se van a examinar. El adaptador puede realizar un examen en un subconjunto o superconjunto de la lista de canales siempre y cuando cumpla los requisitos de tiempo máximo de examen. Si esta lista está vacía, el puerto debe examinar en todos los canales admitidos.

Indicación de finalización de tareas

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

Indicación no solicitada

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

El dispositivo usa esta notificación para indicar al host las actualizaciones de las entradas de BSS. Se puede enviar en cualquier momento.

Requisitos

Cliente mínimo compatible	Windows 10
Servidor mínimo compatible	Windows Server 2016
Encabezado	Dot11wdi.h