Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This I/O control gets the current device power state.

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_RELATIONSHIPstructure.

pBufOut

[out] Set to a pointer to CEDEVICE_POWER_STATE. This returns the current device power state.

dwLenOut

[out] Size of the CEDEVICE_POWER_STATEparameter.

pdwActualOut

[out] Number of bytes passed back in the pBufOutbuffer.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

Power Manager sends this IOCTL only to drivers that support the power management I/O controls.

Power Manager knows the device power state of all power-manageable devices. It does not generally issue an IOCTL_POWER_GETcall to the device unless an application calls GetDevicePowerwith the POWER_FORCE flag set.

Requirements

Header pm.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also