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 bit:
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 membro D2Latency 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 membro D3Latency 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 membro DeviceState 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, PowerSystemSleeping2 e PowerSystemSleeping3, respectivamente). Observe, no entanto, 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 pelo PowerSystemShutdown).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e versões posteriores do sistema operacional Windows. |
| Cabeçalho | wdm.h (inclua Ntddk.h, Ntpoapi.h) |