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
| Requirement | Value |
|---|---|
| Minimum KMDF version | 1.0 |
| Header | wdfchildlist.h (include Wdf.h) |