WDF_RETRIEVE_CHILD_FLAGS Enumeration (wdfchildlist.h)

  • Artikel

[Gilt nur für KMDF]

Die WDF_RETRIEVE_CHILD_FLAGS-Enumeration definiert Flags, die ein Treiber festlegen kann, bevor WdfChildListBeginIteration aufgerufen wird.

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;

Konstanten

 
WdfRetrieveUnspecified
Wert: 0x0000
Nur für die interne Verwendung vorgesehen.
WdfRetrievePresentChildren
Wert: 0x0001
Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, für die ein Frameworkgeräteobjekt vorhanden ist.
WdfRetrieveMissingChildren
Wert: 0x0002
Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die als fehlend gekennzeichnet sind.
WdfRetrievePendingChildren
Wert: 0x0004
Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die der Treiber als vorhanden gemeldet hat, für die jedoch kein Frameworkgeräteobjekt erstellt wurde (da das Framework die EvtChildListCreateDevice-Rückruffunktion des Treibers nicht aufgerufen hat).
WdfRetrieveAddedChildren
Wert: (WdfRetrievePresentChildren
Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die vorhanden sind oder ausstehen.
WdfRetrieveAllChildren
Wert: (WdfRetrievePresentChildren
Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die vorhanden, ausstehend oder fehlen.

Hinweise

Vor dem Aufrufen von WdfChildListBeginIteration muss Ihr Treiber WDF_RETRIEVE_CHILD_FLAGS-typisierte Flags in einer WDF_CHILD_LIST_ITERATOR-Struktur festlegen.

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1.0
Kopfzeile wdfchildlist.h (einschließen von Wdf.h)

Weitere Informationen

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice