WdfFdoUnlockStaticChildListFromIteration function (wdffdo.h)

[Applies to KMDF only]

The WdfFdoUnlockStaticChildListFromIteration method unlocks the list of child devices for a specified device and processes any changes to the list that the driver made while the list was locked.

Syntax

void WdfFdoUnlockStaticChildListFromIteration(
  [in] WDFDEVICE Fdo
);

Parameters

[in] Fdo

A handle to a framework device object that represents the parent device.

Return value

None

Remarks

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

Bus drivers that use static bus enumeration can call WdfFdoUnlockStaticChildListFromIteration.

To lock a child list, the driver calls WdfFdoLockStaticChildListForIteration.

Calls to WdfFdoLockStaticChildListForIteration can be nested and must be matched by an equal number of calls to WdfFdoUnlockStaticChildListFromIteration. If a driver adds or removes items from the child list while it is locked, the framework queues these changes and processes them after the last call to WdfFdoUnlockStaticChildListFromIteration.

For more information about static child lists, see Enumerating the Devices on a Bus.

Examples

For a code example that uses WdfFdoUnlockStaticChildListFromIteration, see WdfFdoRetrieveNextStaticChild.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdffdo.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

WdfFdoLockStaticChildListForIteration