struttura CM_POWER_DATA (ntpoapi.h)
La struttura CM_POWER_DATA contiene informazioni sullo stato e sulle funzionalità di risparmio energia di un dispositivo.
Sintassi
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;
Membri
PD_Size
Dimensione, in byte, di questa struttura.
PD_MostRecentPowerState
Valore DEVICE_POWER_STATE che rappresenta lo stato di alimentazione più recente del dispositivo.
PD_Capabilities
Le funzionalità di alimentazione del dispositivo, rappresentate da una combinazione dei flag di bit seguenti:
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
Latenza del dispositivo quando restituisce lo stato D0 dallo stato D1. Per altre informazioni, vedere il membro D1Latency di DEVICE_CAPABILITIES.
PD_D2Latency
Latenza del dispositivo quando restituisce lo stato D0 dallo stato D2. Per altre informazioni, vedere il membro D2Latency di DEVICE_CAPABILITIES.
PD_D3Latency
Latenza del dispositivo quando restituisce lo stato D0 dallo stato D3. Per altre informazioni, vedere membro D3Latency di DEVICE_CAPABILITIES.
PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM]
Matrice di valori DEVICE_POWER_STATE che rappresenta lo stato massimo di alimentazione del dispositivo ottenibile per ogni stato di alimentazione del sistema. Per altre informazioni, vedere il membro DeviceState di DEVICE_CAPABILITIES.
PD_DeepestSystemWake
Specifica lo stato del sistema meno alimentato da cui il dispositivo può riattivare il sistema. PD_DeepestSystemWake in genere indica uno degli stati di sospensione del sistema, S1, S2 o S3 (come specificato rispettivamente da PowerSystemSleeping1, PowerSystemSleeping2e PowerSystemSleeping3). Si noti, tuttavia, che alcuni dispositivi potrebbero essere in grado di riattivare il sistema dallo stato di ibernazione del sistema, S4 (come specificato da PowerSystemHibernate) o anche dallo stato di arresto del sistema, S5 (come specificato da PowerSystemShutdown).
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e versioni successive del sistema operativo Windows. |
| intestazione | ntpoapi.h (include Ntddk.h, Ntpoapi.h) |