estructura de CM_POWER_DATA (wdm.h)

  • Artículo

La estructura CM_POWER_DATA contiene información sobre el estado y las funcionalidades de administración de energía de un dispositivo.

Sintaxis

typedef struct CM_Power_Data_s {
  ULONG              PD_Size;
  DEVICE_POWER_STATE PD_MostRecentPowerState;
  ULONG              PD_Capabilities;
  ULONG              PD_D1Latency;
  ULONG              PD_D2Latency;
  ULONG              PD_D3Latency;
  DEVICE_POWER_STATE PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM];
  SYSTEM_POWER_STATE PD_DeepestSystemWake;
} CM_POWER_DATA, *PCM_POWER_DATA;

Miembros

PD_Size

Tamaño, en bytes, de esta estructura.

PD_MostRecentPowerState

Valor de DEVICE_POWER_STATE que representa el estado de alimentación más reciente del dispositivo.

PD_Capabilities

Las funcionalidades de energía del dispositivo, representadas por una combinación de las marcas de bits siguientes:

PDCAP_D0_SUPPORTED

PDCAP_D1_SUPPORTED

PDCAP_D2_SUPPORTED

PDCAP_D3_SUPPORTED

PDCAP_WAKE_FROM_D0_SUPPORTED

PDCAP_WAKE_FROM_D1_SUPPORTED

PDCAP_WAKE_FROM_D2_SUPPORTED

PDCAP_WAKE_FROM_D3_SUPPORTED

PDCAP_WARM_EJECT_SUPPORTED

PD_D1Latency

Latencia del dispositivo al devolver el estado D0 del estado D1. Para obtener más información, consulte el miembro D1Latency de DEVICE_CAPABILITIES.

PD_D2Latency

Latencia del dispositivo al devolver el estado D0 del estado D2. Para obtener más información, consulte el miembro D2Latency de DEVICE_CAPABILITIES.

PD_D3Latency

Latencia del dispositivo al devolver el estado D0 del estado D3. Para obtener más información, consulte el miembro D3Latency de DEVICE_CAPABILITIES.

PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM]

Matriz de valores de DEVICE_POWER_STATE que representan el estado máximo de energía del dispositivo que se puede lograr para cada estado de alimentación del sistema. Para obtener más información, consulte el miembro DeviceState de DEVICE_CAPABILITIES.

PD_DeepestSystemWake

Especifica el estado del sistema con menos tecnología desde el que el dispositivo puede reactivar el sistema. PD_DeepestSystemWake normalmente indica uno de los estados de suspensión del sistema, S1, S2 o S3 (según lo especificado por PowerSystemSleeping1, PowerSystemSleeping2 y PowerSystemSleeping3, respectivamente). Sin embargo, tenga en cuenta que algunos dispositivos pueden reactivar el sistema desde el estado de hibernación del sistema, S4 (especificado por PowerSystemHibernate), o incluso desde el estado de apagado del sistema, S5 (según lo especificado por PowerSystemShutdown).

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows XP y versiones posteriores del sistema operativo Windows.
Encabezado wdm.h (include Ntddk.h, Ntpoapi.h)

Consulte también

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty