IOCTL_POWER_SET

  • Article

This IOCTL requests a change from one device power state to another.

Parameters

  • pBufIn
    [in] Set to a pointer to POWER_RELATIONSHIP. This defines the target device for parent and bus drivers. Otherwise, set to NULL.

  • dwLenIn
    [in] Size of the POWER_RELATIONSHIP structure.

  • pBufOut
    [in] Set to a pointer to CEDEVICE_POWER_STATE. This is the device state in which to put the device.

    [out] Optional. Set to an adjusted power state if the driver does not support the requested power state.

  • dwLenOut
    [out] Size of the CEDEVICE_POWER_STATE parameter.

  • pdwActualOut
    [out] Number of bytes passed back in the pBufOut buffer.

Return Values

TRUE if successful, FALSE otherwise.

Remarks

If the driver does not support the proposed device power state, then it should write its adjusted device power state into pBufOut.

The Power Manager will only send this IOCTL to drivers that support the power management IOCTLs.

All drivers that account for power must handle this IOCTL.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Pm.h.

See Also

CEDEVICE_POWER_STATE | POWER_RELATIONSHIP

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.