WdfFdoLockStaticChildListForIteration, fonction (wdffdo.h)
[S’applique uniquement à KMDF]
La méthode WdfFdoLockStaticChildListForIteration prépare l’infrastructure à la récupération des éléments de la liste enfant statique qui appartient à un appareil parent spécifié.
Syntaxe
void WdfFdoLockStaticChildListForIteration(
[in] WDFDEVICE Fdo
);
Paramètres
[in] Fdo
Handle d’un objet d’appareil framework qui représente l’appareil parent.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Les pilotes de bus qui utilisent l’énumération de bus statique peuvent appeler WdfFdoLockStaticChildListForIteration.
Après avoir appelé WdfFdoLockStaticChildListForIteration, le pilote peut appeler À plusieurs reprises WdfFdoRetrieveNextStaticChild pour obtenir des informations sur chaque appareil enfant de la liste enfant.
Une fois que le pilote a terminé d’appeler WdfFdoRetrieveNextStaticChild, il doit appeler WdfFdoUnlockStaticChildListFromIteration.
Si le pilote apporte des modifications à la liste enfant après avoir appelé WdfFdoLockStaticChildListForIteration, le framework stocke toutes les modifications et avertit le gestionnaire Plug-and-Play (PnP) des modifications lorsque le pilote appelle WdfFdoUnlockStaticChildListFromIteration.
Le pilote peut imbriquer des appels à WdfFdoLockStaticChildListForIteration et WdfFdoUnlockStaticChildListFromIteration. Si le pilote imbrique les appels à ces méthodes, l’infrastructure stocke toutes les modifications jusqu’au dernier appel à WdfFdoUnlockStaticChildListFromIteration.
Pour plus d’informations sur les listes enfants statiques, consultez Énumération statique.
Exemples
Pour obtenir un exemple de code qui utilise WdfFdoLockStaticChildListForIteration, consultez WdfFdoRetrieveNextStaticChild.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdffdo.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |