Partager via


WdfChildListBeginScan, fonction (wdfchildlist.h)

[S’applique à KMDF uniquement]

La méthode WdfChildListBeginScan prépare une liste spécifiée d’appareils enfants afin que le pilote puisse mettre à jour les informations de la liste.

Syntaxe

void WdfChildListBeginScan(
  [in] WDFCHILDLIST ChildList
);

Paramètres

[in] ChildList

Handle pour un objet de liste enfant du framework.

Valeur de retour

None

Remarques

Un bogue case activée 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 la mise à jour de la liste enfant terminée, le pilote doit appeler WdfChildListEndScan. Cet appel remet la liste enfant mise à jour au gestionnaire Plug-and-Play (PnP). Par la suite, l’infrastructure appelle la fonction de rappel EvtChildListCreateDevice du pilote pour chaque appareil signalé par le pilote.

Pour plus d’informations sur les listes enfants, consultez Énumération dynamique.

Exemples

Pour obtenir un exemple de code qui utilise WdfChildListBeginScan, consultez WdfChildListAddOrUpdateChildDescriptionAsPresent.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfchildlist.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent