énumération WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

  • Article

[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