Funzione PowerReadACValue (powersetting.h)

Recupera il valore di alimentazione AC per l'impostazione di alimentazione specificata.

Sintassi

DWORD PowerReadACValue(
  [in, optional]      HKEY       RootPowerKey,
  [in, optional]      const GUID *SchemeGuid,
  [in, optional]      const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional]      const GUID *PowerSettingGuid,
  [out, optional]     PULONG     Type,
  [out, optional]     LPBYTE     Buffer,
  [in, out, optional] LPDWORD    BufferSize
);

Parametri

[in, optional] RootPowerKey

Questo parametro è riservato per uso futuro e deve essere impostato su NULL.

[in, optional] SchemeGuid

Identificatore dello schema di alimentazione.

[in, optional] SubGroupOfPowerSettingsGuid

Sottogruppo di impostazioni di risparmio energia. Questo parametro può essere uno dei valori seguenti definiti in WinNT.h. Usare NO_SUBGROUP_GUID per recuperare l'impostazione per lo schema di alimentazione predefinito.

[in, optional] PowerSettingGuid

Identificatore dell'impostazione di alimentazione.

[out, optional] Type

Puntatore a una variabile che riceve il tipo di dati per il valore. I valori possibili sono elencati in Tipi di valore del Registro di sistema. Questo parametro può essere NULL e il tipo di dati non viene restituito.

[out, optional] Buffer

Puntatore a un buffer che riceve il valore dei dati. Se questo parametro è NULL, il parametro BufferSize riceve le dimensioni del buffer necessarie.

[in, out, optional] BufferSize

Puntatore a una variabile che contiene le dimensioni del buffer a cui punta il parametro Buffer .

Se il parametro Buffer è NULL, la funzione restituisce ERROR_SUCCESS e la variabile riceve le dimensioni del buffer necessarie.

Se le dimensioni del buffer specificate non sono sufficienti per contenere i dati richiesti, la funzione restituisce ERROR_MORE_DATA e la variabile riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS (zero) se la chiamata ha avuto esito positivo e un valore diverso da zero se la chiamata non è riuscita. Se la dimensione del buffer specificata dal parametro BufferSize è troppo piccola, ERROR_MORE_DATA verrà restituita e la DWORD a cui punta il parametro BufferSize verrà riempita con le dimensioni del buffer necessarie.

Requisiti

Vedi anche

Funzioni di risparmio energia