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 checks device-specific capabilities.

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 POWER_CAPABILITIES. This defines the devices power capabilities.

dwLenOut

[out] Size of the POWER_CAPABILITIESstructure.

pdwActualOut

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

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

If a driver fails this I/O control, Power Manager assumes that the driver does not handle the remaining I/O controls and does not send them. As a minimum, the driver should complete the DeviceDxin POWER_CAPABILITIES.

During initialization, through this I/O control, the device driver should put the device into D0 and report device capabilities as accurately as possible when queried by Power Manager.

All drivers that support Power Manager must handle this I/O control.

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