WdfFdoUnlockStaticChildListFromIteration method

[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

Fdo [in]

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

Return value

None.

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

Remarks

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

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, KmdfIrql, KmdfIrql2

See also

WdfFdoLockStaticChildListForIteration

 

 

Send comments about this topic to Microsoft

Show: