WDF_CHILD_LIST_ITERATOR structure

[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

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

Minimum KMDF version

1.0

Header

Wdfchildlist.h (include Wdf.h)

See also

WDF_CHILD_LIST_ITERATOR_INIT
WDF_RETRIEVE_CHILD_FLAGS
WdfChildListBeginIteration
WdfChildListEndIteration
WdfChildListRetrieveNextDevice

 

 

Send comments about this topic to Microsoft

Show: