WdfChildListBeginScan, fonction (wdfchildlist.h)
[S’applique uniquement à KMDF]
La méthode WdfChildListBeginScan prépare une liste spécifiée de périphériques enfants afin que le pilote puisse mettre à jour les informations de la liste.
Syntaxe
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Paramètres
[in] ChildList
Handle d’un objet de liste enfant framework.
Valeur de retour
Aucun
Remarques
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
La méthode WdfChildListBeginScan marque tous les appareils enfants de la liste comme manquants.
Après avoir appelé WdfChildListBeginScan, le pilote peut appeler WdfChildListAddOrUpdateChildDescriptionAsPresent à plusieurs reprises, ou appeler WdfChildListUpdateAllChildDescriptionsAsPresent, pour signaler tous les appareils enfants actuellement attachés à l’appareil parent.
Une fois que le pilote a terminé la mise à jour de la liste enfant, il doit appeler WdfChildListEndScan. Cet appel remet la liste enfant mise à jour au gestionnaire Plug-and-Play (PnP). Par la suite, l’infrastructure appelle la EvtChildListCreateDevice du pilote fonction de rappel pour chaque périphérique signalé par le pilote.
Pour plus d’informations sur les listes enfants, consultez d’énumération dynamique .
Exemples
Pour obtenir un exemple de code qui utilise WdfChildListBeginScan, consultez WdfChildListAddOrUpdateChildDescriptionAsPresent.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| d’en-tête | wdfchildlist.h (include Wdf.h) |
| bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |