WdfFdoLockStaticChildListForIteration, fonction (wdffdo.h)

  • Article

[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)

Voir aussi

WdfFdoUnlockStaticChildListFromIteration