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) |