WdfDeviceInitSetPowerInrush function (wdfdevice.h)
[Applies to KMDF only]
The WdfDeviceInitSetPowerInrush method informs the power manager that the specified device requires an inrush of current when it starts.
Syntax
void WdfDeviceInitSetPowerInrush(
[in] PWDFDEVICE_INIT DeviceInit
);
Parameters
[in] DeviceInit
A caller-supplied pointer to a WDFDEVICE_INIT structure.
Return value
None
Remarks
To avoid overloading the system's power supply, the system starts devices that require an inrush of current one at a time.
If your driver calls WdfDeviceInitSetPowerInrush, the framework makes it nonpageable during power state transitions and the driver must not call WdfDeviceInitSetPowerPageable.
Your driver must call WdfDeviceInitSetPowerInrush before it calls WdfDeviceCreate. For more information about calling WdfDeviceCreate, see Creating a Framework Device Object.
Calling WdfDeviceInitSetPowerInrush from a filter driver has no effect. For filter drivers, the framework uses the setting that the next-lower driver in the driver stack specifies.
Examples
The following code example informs the power manager that a device requires an inrush of current when it starts.
WdfDeviceInitSetPowerInrush(DeviceInit);
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Minimum KMDF version | 1.0 |
| Header | wdfdevice.h (include Wdf.h) |
| Library | Wdf01000.sys (see Framework Library Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI compliance rules | ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |