WDF_CHILD_LIST_ITERATOR structure (wdfchildlist.h)

Article
02/26/2024

[S’applique à KMDF uniquement]

La structure WDF_CHILD_LIST_ITERATOR identifie le type d’appareils enfants que l’infrastructure récupère lorsqu’un pilote appelle WdfChildListRetrieveNextDevice.

Syntaxe

typedef struct _WDF_CHILD_LIST_ITERATOR {
  ULONG Size;
  ULONG Flags;
  PVOID Reserved[4];
} WDF_CHILD_LIST_ITERATOR, *PWDF_CHILD_LIST_ITERATOR;

Membres

Size

Taille, en octets, de cette structure.

Flags

Un ou plusieurs indicateurs définis par l’énumération WDF_RETRIEVE_CHILD_FLAGS .

Reserved[4]

Réservé à un usage interne uniquement.

Remarques

Le pilote doit initialiser la structure WDF_CHILD_LIST_ITERATOR en appelant WDF_CHILD_LIST_ITERATOR_INIT.

La structure WDF_CHILD_LIST_ITERATOR est utilisée comme entrée pour les méthodes WdfChildListBeginIteration, WdfChildListRetrieveNextDevice et WdfChildListEndIteration . Le pilote doit définir le membre Flags avant d’appeler WdfChildListBeginIteration. Après avoir appelé WdfChildListBeginIteration, le pilote ne doit pas modifier le contenu de la structure avant d’avoir appelé WdfChildListEndIteration.

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