WDF_RETRIEVE_CHILD_FLAGS-Aufzählung (wdfchildlist.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WDF_RETRIEVE_CHILD_FLAGS-Aufzählung definiert Flags, die ein Treiber festlegen kann, bevor WdfChildListBeginIterationaufgerufen 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 reserviert.
`WdfRetrievePresentChildren` Wert: 0x0001 Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, für die ein Framework-Geräteobjekt vorhanden ist.
`WdfRetrieveMissingChildren` Wert: 0x0002 Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die als fehlen gekennzeichnet sind.
`WdfRetrievePendingChildren` Wert: 0x0004 Aufrufe an WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die der Treiber als vorhanden gemeldet hat, aber für die kein Framework-Gerä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 oder ausstehen.
`WdfRetrieveAllChildren` Wert: (WdfRetrievePresentChildren Aufrufe von WdfChildListRetrieveNextDevice rufen untergeordnete Geräte ab, die vorhanden, ausstehend oder fehlen.

Bemerkungen

Vor dem Aufrufen WdfChildListBeginIteration-muss Ihr Treiber WDF_RETRIEVE_CHILD_FLAGS-typed flags in einer WDF_CHILD_LIST_ITERATOR-Struktur festlegen.

Anforderungen

Anforderung	Wert
Minimale KMDF-Version	1.0
Header-	wdfchildlist.h (include Wdf.h)

Siehe auch

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice

Freigeben über