WDF_CHILD_LIST_ITERATOR structure (wdfchildlist.h)

[Applies to KMDF only]

The WDF_CHILD_LIST_ITERATOR structure identifies the type of child devices that the framework will retrieve when a driver calls WdfChildListRetrieveNextDevice.

Syntax

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

Members

Size

The size, in bytes, of this structure.

Flags

One or more flags that are defined by the WDF_RETRIEVE_CHILD_FLAGS enumeration.

Reserved[4]

Reserved for internal use only.

Remarks

The driver must initialize the WDF_CHILD_LIST_ITERATOR structure by calling WDF_CHILD_LIST_ITERATOR_INIT.

The WDF_CHILD_LIST_ITERATOR structure is used as input to the WdfChildListBeginIteration,WdfChildListRetrieveNextDevice ,and WdfChildListEndIteration methods. The driver must set the Flags member before calling WdfChildListBeginIteration. After calling WdfChildListBeginIteration, the driver must not modify the structure's contents until after calling WdfChildListEndIteration.

For more information about child lists, see Dynamic Enumeration.

Requirements

See also

WDF_CHILD_LIST_ITERATOR_INIT

WDF_RETRIEVE_CHILD_FLAGS

WdfChildListBeginIteration

WdfChildListEndIteration

WdfChildListRetrieveNextDevice