OID_WDI_SET_P2P_START_BACKGROUND_DISCOVERY

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é en Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

OID_WDI_SET_P2P_START_BACKGROUND_DISCOVERY indique à l’adaptateur d’effectuer régulièrement Wi-Fi détection directe en arrière-plan

Étendue	Définir sérialisé avec la tâche	Temps d’exécution normal (secondes)	Affecte le débit/la latence des données
Port	Non	1	Oui

L’adaptateur est nécessaire pour analyser les canaux spécifiés à intervalles réguliers et être en mesure de trouver un appareil qui devient détectable dans le délai de visibilité de l’appareil (généralement 5 minutes). Le comportement est similaire à l’analyse de découverte directe Wi-Fi standard (comme défini dans OID_WDI_TASK_P2P_DISCOVER), mais il n’est pas limité dans le temps, et l’adaptateur peut planifier les analyses à un moment ultérieur. L’adaptateur doit effectuer au moins une analyse dans chaque délai de visibilité de l’appareil. Si le délai d’expiration de la visibilité de l’appareil est de 0, l’adaptateur doit continuer à analyser régulièrement à l’aide de sa propre durée de cycle. Si une demande de tâche DISCOVER ou SCAN est effectuée pendant ce temps, l’adaptateur doit suspendre la découverte en arrière-plan pendant toute la durée de la tâche et continuer lorsque la tâche est terminée. À l’issue d’une analyse en arrière-plan, l’appareil doit envoyer l’indication NDIS_STATUS_WDI_INDICATION_P2P_DISCOVERY_COMPLETE (avec l’ID de transaction égal à 0) pour informer le système d’exploitation qu’il a terminé une analyse. L’adaptateur doit envoyer cette indication chaque fois qu’il effectue une analyse en arrière-plan.

Si la liste des canaux est fournie, l’adaptateur doit analyser uniquement sur les canaux spécifiés. Sinon, il doit analyser tous les canaux. Si le microprogramme a découvert un appareil en dehors des canaux spécifiés, il doit toujours envoyer les informations au système d’exploitation.

Lorsque la durée d’écoute et les canaux (WDI_TLV_P2P_DISCOVERY_CHANNEL_SETTINGS) sont spécifiés, ils font référence aux heures d’écoute des appareils distants. En fonction de toutes les valeurs de durée d’écoute et de canaux, l’adaptateur doit mettre en place une planification pour analyser les canaux demandés de la manière la plus efficace possible. Le système d’exploitation peut également spécifier plusieurs instances de durée d’écoute et de canaux. Dans ce cas, l’adaptateur doit d’abord proposer la planification d’analyse pour les entrées qui ont des valeurs non nulles de durée d’écoute et de liste de canaux. Ensuite, l’adaptateur doit utiliser les valeurs par défaut dans les cas suivants :

1. Si la durée d’écoute est 0, l’adaptateur doit utiliser les heures d’analyse par défaut pour les canaux spécifiés.
2. Si la liste des canaux est vide, l’adaptateur doit analyser tous les canaux de cette bande à l’aide des heures d’écoute et de cycle spécifiées pour cette bande. Les durées d’analyse ne s’appliquent pas aux canaux qui ont des durées d’écoute distinctes spécifiées par le système d’exploitation.

Lorsque la carte réseau est en D0, l’adaptateur indique les réponses aux demandes de sonde pour le ou les noms de service spécifiques en tant que notifications NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST au système d’exploitation. WDI met en cache les informations de réponse du système d’exploitation pour les services de couche supérieure et les avertit si nécessaire.

Lorsque la carte réseau se trouve dans D2, elle suspend la découverte en arrière-plan jusqu’à ce qu’elle revient à D0.

Définir les paramètres de propriété

TLV	Plusieurs instances TLV autorisées	Facultatif	Description
WDI_TLV_P2P_BACKGROUND_DISCOVER_MODE			Wi-Fi paramètres du mode de découverte en arrière-plan direct.
WDI_TLV_P2P_DISCOVERY_CHANNEL_SETTINGS	X	X	Liste des canaux recommandés à analyser.
WDI_TLV_P2P_DEVICE_FILTER_LIST		X	Liste des Wi-Fi Appareils directs et propriétaires de groupes à rechercher pendant Wi-Fi découverte d’appareils direct.
WDI_TLV_P2P_SERVICE_NAME_HASH	X	X	Liste des noms de hachage de service à interroger. Cela est obligatoire si WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_NAME_ONLY est spécifié.
WDI_TLV_VENDOR_SPECIFIC_IE		X	Un ou plusieurs E/S qui doivent être inclus dans les demandes de sonde envoyées par le port.

Définir les résultats de la propriété

Aucune donnée supplémentaire. Les données de l’en-tête sont suffisantes.

Indication non sollicitée

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

Configuration requise

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