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)

See also

EvtDriverDeviceAdd

WdfDeviceCreate