Compartir a través de

POWER_CAPABILITIES (Compact 2013)

  • Artículo

3/26/2014

This structure is used for drivers to report the power management capabilities of a device.

Syntax

typedef struct _POWER_CAPABILITIES {
  UCHAR DeviceDx;
  UCHAR WakeFromDx;
  UCHAR InrushDx;
  DWORD Power[5];
  DWORD Latency[5];
  DWORD Flags;
} POWER_CAPABILITIES, *PPOWER_CAPABILITIES;

Members

  • DeviceDx
    Bit mask that indicates whether the device hardware supports these device states. Each is a single bit, set if the device supports the state, and clear if the device does not support the state.
  • WakeFromDx
    Bit mask that indicates whether the device hardware can awaken in response to an external signal that arrives when the device is in the specified state. Each is a single bit, set if the device supports wake from the state, and clear if the device does not support wake from the state.

  • InrushDx
    Bit mask that indicates whether the device hardware has inrush requirements at the specified device state. Each is a single bit, set if the device has inrush requirements at the state, and clear if the device does not. Drivers for devices that require an inrush of power at the specified state must set the appropriate bits. Bus drivers may need to set Inrush. The flag notifies Power Manager that such devices must be powered up one at a time, in sequence with other such devices.

    Inrush is a sudden rushing in of power.

  • Power
    This is an array of five values, indexed by the CEDEVICE_POWER_STATE values ranging from D0 to D4. Each element of the array contains the maximum or highest-power usage, in milliwatts, that the device uses for the device power state denoted by the array index, or PwrDeviceUnspecified if the system state is not supported. Devices with their own power supplies, even if it is a self-contained battery, should only report their drains on the system power supply.
  • Latency
    Contains an array of the approximate time, in milliseconds, that the device requires to return to the D0 state from each of the specified states. A driver should specify a latency time of PwrDeviceUnspecified for any device state it does not support.
  • Flags
    Set to POWER_CAP_PARENT bit if the device should receive an IOCTL_REGISTER_POWER_RELATIONSHIP call after initialization.

Remarks

During enumeration, drivers report device-specific information in response to an IOCTL_POWER_CAPABILITIES query request.

Requirements

Header

pm.h

See Also

Reference

Power Management Structures
CEDEVICE_POWER_STATE
IOCTL_POWER_CAPABILITIES