WdfChildListEndIteration method

[Applies to KMDF only]

The WdfChildListEndIteration method processes modifications to a specified child list.

Syntax


VOID WdfChildListEndIteration(
  [in] WDFCHILDLIST             ChildList,
  [in] PWDF_CHILD_LIST_ITERATOR Iterator
);

Parameters

ChildList [in]

The same handle to a framework child-list object that the driver previously specified to WdfChildListBeginIteration.

Iterator [in]

A pointer to the same caller-allocated WDF_CHILD_LIST_ITERATOR structure that the driver previously supplied to WdfChildListEndIteration.

Return value

None.

A system bug check occurs if the driver supplies an invalid object handle.

Remarks

If the driver has made multiple calls to WdfChildListBeginIteration or WdfChildListBeginScan, the framework does not process modifications to the child list until the driver has made a corresponding number of calls to WdfChildListEndIteration and WdfChildListEndScan.

For more information about child lists, see Dynamic Enumeration.

Examples

For a code example that uses WdfChildListEndIteration, see WdfChildListRetrieveNextDevice.

Requirements

Target platform

Universal

Minimum KMDF version

1.0

Header

Wdfchildlist.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

DriverCreate, KmdfIrql, KmdfIrql2

See also

WDF_CHILD_LIST_ITERATOR
WdfChildListBeginIteration
WdfChildListBeginScan
WdfChildListEndScan

 

 

Send comments about this topic to Microsoft

표시:
© 2015 Microsoft