énumération WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

Article
03/01/2024

[S’applique à KMDF uniquement]

L’énumération WDF_RETRIEVE_CHILD_FLAGS définit les indicateurs qu’un pilote peut définir avant d’appeler WdfChildListBeginIteration.

Syntax

typedef enum _WDF_RETRIEVE_CHILD_FLAGS {
  WdfRetrieveUnspecified = 0x0000,
  WdfRetrievePresentChildren = 0x0001,
  WdfRetrieveMissingChildren = 0x0002,
  WdfRetrievePendingChildren = 0x0004,
  WdfRetrieveAddedChildren = (WdfRetrievePresentChildren | WdfRetrievePendingChildren),
  WdfRetrieveAllChildren = (WdfRetrievePresentChildren | WdfRetrievePendingChildren | WdfRetrieveMissingChildren)
} WDF_RETRIEVE_CHILD_FLAGS;

Constantes


`WdfRetrieveUnspecified` Valeur : 0x0000 Réservé à un usage interne uniquement.
`WdfRetrievePresentChildren` Valeur : 0x0001 Les appels à WdfChildListRetrieveNextDevice récupèrent les appareils enfants pour lesquels il existe un objet d’appareil framework.
`WdfRetrieveMissingChildren` Valeur : 0x0002 Les appels à WdfChildListRetrieveNextDevice récupèrent les appareils enfants marqués comme manquants.
`WdfRetrievePendingChildren` Valeur : 0x0004 Les appels à WdfChildListRetrieveNextDevice récupèrent les appareils enfants que le pilote a signalés comme présents, mais pour lesquels aucun objet de périphérique d’infrastructure n’a été créé (car l’infrastructure n’a pas appelé la fonction de rappel EvtChildListCreateDevice du pilote).
`WdfRetrieveAddedChildren` Valeur : (WdfRetrievePresentChildren Les appels à WdfChildListRetrieveNextDevice récupèrent les appareils enfants présents ou en attente.
`WdfRetrieveAllChildren` Valeur : (WdfRetrievePresentChildren Les appels à WdfChildListRetrieveNextDevice récupèrent les appareils enfants présents, en attente ou manquants.

Remarques

Avant d’appeler WdfChildListBeginIteration, votre pilote doit définir des indicateurs WDF_RETRIEVE_CHILD_FLAGS typés dans une structure WDF_CHILD_LIST_ITERATOR .

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1.0
En-tête	wdfchildlist.h (inclure Wdf.h)

Voir aussi

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice

Partager via