estrutura CM_POWER_DATA (wdm.h)
A estrutura CM_POWER_DATA contém informações sobre o estado e os recursos de gerenciamento de energia de um dispositivo.
Sintaxe
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;
Membros
PD_Size
O tamanho, em bytes, dessa estrutura.
PD_MostRecentPowerState
Um valor DEVICE_POWER_STATE que representa o estado de energia mais recente do dispositivo.
PD_Capabilities
Os recursos de energia do dispositivo, representados por uma combinação dos seguintes sinalizadores de bits:
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
A latência do dispositivo ao retornar o estado D0 do estado D1. Para obter mais informações, consulte o membro D1Latency do DEVICE_CAPABILITIES.
PD_D2Latency
A latência do dispositivo ao retornar o estado D0 do estado D2. Para obter mais informações, consulte o D2Latency membro do DEVICE_CAPABILITIES.
PD_D3Latency
A latência do dispositivo ao retornar o estado D0 do estado D3. Para obter mais informações, consulte o D3Latency membro do DEVICE_CAPABILITIES.
PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM]
Uma matriz de valores DEVICE_POWER_STATE que representam o estado máximo de energia do dispositivo alcançável para cada estado de energia do sistema. Para obter mais informações, consulte o devicestate membro do DEVICE_CAPABILITIES.
PD_DeepestSystemWake
Especifica o estado do sistema menos alimentado do qual o dispositivo pode ativar o sistema. PD_DeepestSystemWake normalmente indica um dos estados de suspensão do sistema, S1, S2 ou S3 (conforme especificado por powersystemsleeping1, powersystemsleeping2e powersystemsleeping3, respectivamente). No entanto, observe que alguns dispositivos podem ser capazes de ativar o sistema do estado de hibernação do sistema, S4 (conforme especificado por PowerSystemHibernate), ou até mesmo do estado de desligamento do sistema, S5 (conforme especificado por PowerSystemShutdown).
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e versões posteriores do sistema operacional Windows. |
| cabeçalho | wdm.h (include Ntddk.h, Ntpoapi.h) |