énumération WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

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

Syntaxe

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é uniquement pour une utilisation interne.
`WdfRetrievePresentChildren` Valeur : 0x0001 Les appels à WdfChildListRetrieveNextDevice récupèrent les appareils enfants pour lesquels un objet d’appareil framework existe.
`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 périphériques enfants signalés comme étant présents, mais pour lesquels un objet d’appareil framework n’a pas é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 WDF_RETRIEVE_CHILD_FLAGSindicateurs typés dans une structure WDF_CHILD_LIST_ITERATOR.

Exigences

Exigence	Valeur
version minimale de KMDF	1.0
d’en-tête	wdfchildlist.h (include Wdf.h)

Voir aussi

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice

Partager via