OID_WDI_TASK_SCAN

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

OID_WDI_TASK_SCAN demande une enquête sur les réseaux BSS. Le port effectue une analyse conformément aux exigences de la spécification IEEE 802.11.

Object	Capacité d’abandon	Priorité par défaut (stratégie de pilote hôte)	Temps d’exécution normal (secondes)
Port	Oui. Le port doit être dans un état propre après l’abandon.	6 (analyse en arrière-plan) 5 (analyse initiée par l’utilisateur)	4

Un message de démarrage de tâche contenant un WDI_TLV_STATUS est indiqué une fois que le port a démarré l’analyse et qu’il est prêt à recevoir d’autres commandes.

Une fois qu’une analyse est démarrée lorsqu’elle est activée par LiveUpdatesNeededed, le port doit fournir des mises à jour incrémentielles (en utilisant des indications non sollicitées de NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST) sur les entrées BSS découvertes. Les entrées BSS qui avaient déjà été découvertes mais qui n’ont pas été trouvées par le port dans l’analyse en cours ne doivent pas être signalées par le port. Pour des raisons d’alimentation et de performances, le port doit limiter les indications et envoyer des mises à jour à l’hôte uniquement lorsqu’il en a découvert 3 ou plus, ou lorsqu’il a découvert moins de 3 entrées, mais qu’il ne les a pas signalées à l’hôte pendant plus de 500 millisecondes. Une fois l’analyse terminée, si l’adaptateur ne gère pas les entrées BSS, il n’a pas besoin de mémoriser les entrées BSS qu’il a découvertes. Une fois l’opération d’analyse terminée, le port doit envoyer la notification complète de la tâche au système d’exploitation et arrêter de signaler les entrées BSS à l’hôte. La commande d’analyse est utilisée pour rechercher les réseaux hérités (non Wi-Fi Direct) et le port ne doit pas inclure les Wi-Fi les IE directes dans les demandes de sonde.

Si l’adaptateur ne gère pas les entrées BSS, l’hôte se souvient des entrées BSS signalées par le port à partir d’une analyse pendant une période limitée. Il horoda ses entrées mises en cache et les vide. Si l’adaptateur gère les entrées BSS, il les met en cache et les délai d’expiration. L’hôte peut envoyer la commande OID_WDI_SET_FLUSH_BSS_ENTRY pour vider explicitement les entrées.

L’hôte effectue le suivi des entrées BSS à l’aide de son BSSID. Si le port signale deux entrées BSS pour le même BSSID, l’hôte remplace l’une par l’autre.

Pendant que l’analyse est en cours, le port doit conserver les connexions existantes (par exemple, Infrastructure ou Wi-Fi Direct). Si des connexions existent déjà, le port doit analyser un sous-ensemble de canaux à la fois et entre les sous-ensembles, pour fournir aux autres connexions l’accès au support. Pendant l’analyse, l’hôte peut envoyer des demandes d’envoi de paquets à n’importe quel port de l’adaptateur.

Dans les entrées BSS indiquées, le port peut inclure des informations de contexte spécifiques à l’appareil. Ces informations de contexte sont renvoyées à l’appareil si le port est invité à se connecter à cette entrée BSS. Toutefois, ce contexte peut être effacé automatiquement par l’hôte si l’entrée BSS est vidée.

La commande d’analyse peut être abandonnée. Lors de la réception de la commande d’abandon, le port doit cesser d’essayer de trouver de nouveaux réseaux BSS et terminer la tâche d’analyse dès que possible. Une fois la tâche terminée (normalement ou en raison d’un abandon), le port doit être dans un bon état afin qu’une autre analyse puisse être émise sur ce port.

L’adaptateur ne doit pas violer les restrictions réglementaires lors de l’exécution d’une analyse.

Paramètres de tâche

TLV	Plusieurs instances TLV autorisées	Facultatif	Description
WDI_TLV_BSSID			BSSID du réseau à analyser. S’il s’agit de l’adresse MAC de diffusion, la station analyse tous les BSSID.
WDI_TLV_SSID	X		Liste de SSID que le port doit analyser. Cette liste peut contenir plusieurs SSID et l’un d’eux peut être un caractère générique. Lors d’une analyse active sur un canal, le port doit envoyer une demande de sonde pour chaque SSID de la liste. Si cette liste est vide, le port doit rechercher tous les SSID.
WDI_TLV_VENDOR_SPECIFIC_IE		X	Une ou plusieurs IE qui doivent être incluses dans les demandes de sonde envoyées par le port. Ces EI ne sont pas utilisés pour l’analyse passive.
WDI_TLV_SCAN_MODE			Paramètres du mode d’analyse.
WDI_TLV_SCAN_DWELL_TIME			Paramètres de temps de vie.
WDI_TLV_BAND_CHANNEL	X	X	Liste des canaux recommandés à analyser. L’adaptateur peut effectuer une analyse sur un sous-ensemble ou un sur-ensemble de la liste des canaux tant qu’il répond aux exigences de durée d’analyse maximale. Si cette liste est vide, le port doit analyser tous les canaux pris en charge.

Indication de fin de tâche

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

Indication non sollicitée

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

Cette notification est utilisée par l’appareil pour informer l’hôte des mises à jour des entrées BSS. Il peut être envoyé à tout moment.

Configuration requise

Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
En-tête	Dot11wdi.h