WDF_CHILD_LIST_ITERATOR-Struktur (wdfchildlist.h)

[Gilt nur für KMDF]

Die WDF_CHILD_LIST_ITERATOR-Struktur gibt den Typ der untergeordneten Geräte an, die das Framework abruft, wenn ein Treiber WdfChildListRetrieveNextDevice aufruft.

Syntax

typedef struct _WDF_CHILD_LIST_ITERATOR {
  ULONG Size;
  ULONG Flags;
  PVOID Reserved[4];
} WDF_CHILD_LIST_ITERATOR, *PWDF_CHILD_LIST_ITERATOR;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Flags

Mindestens ein Flag, das von der WDF_RETRIEVE_CHILD_FLAGS-Enumeration definiert wird.

Reserved[4]

Nur für die interne Verwendung vorgesehen.

Hinweise

Der Treiber muss die WDF_CHILD_LIST_ITERATOR-Struktur initialisieren, indem WDF_CHILD_LIST_ITERATOR_INIT aufgerufen wird.

Die WDF_CHILD_LIST_ITERATOR-Struktur wird als Eingabe für die Methoden WdfChildListBeginIteration, WdfChildListRetrieveNextDevice und WdfChildListEndIteration verwendet. Der Treiber muss das Flags-Element festlegen, bevor WdfChildListBeginIteration aufgerufen wird. Nach dem Aufruf von WdfChildListBeginIteration darf der Treiber den Inhalt der Struktur erst nach dem Aufruf von WdfChildListEndIteration ändern.

Weitere Informationen zu untergeordneten Listen finden Sie unter Dynamische Enumeration.

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1.0
Kopfzeile wdfchildlist.h (include Wdf.h)

Weitere Informationen

WDF_CHILD_LIST_ITERATOR_INIT

WDF_RETRIEVE_CHILD_FLAGS

WdfChildListBeginIteration

WdfChildListEndIteration

WdfChildListRetrieveNextDevice