estrutura CM_POWER_DATA (wdm.h)

  • Artigo

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)

Confira também

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty