Funzione EnumPwrSchemes (powrprof.h)

Articolo
03/05/2024

[EnumPwrSchemes è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Le applicazioni scritte per Windows Vista e versioni successive devono usare invece PowerEnumerate .

Enumera tutti gli schemi di alimentazione. Per ogni schema di alimentazione enumerato, la funzione chiama una funzione di callback con informazioni sullo schema di alimentazione.

Sintassi

BOOLEAN EnumPwrSchemes(
  [in] PWRSCHEMESENUMPROC lpfn,
  [in] LPARAM             lParam
);

Parametri

[in] lpfn

Puntatore a una funzione di callback da chiamare per ogni schema di alimentazione enumerato. Per altre informazioni, vedere la sezione Osservazioni.

[in] lParam

Valore definito dall'utente da passare alla funzione di callback.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per ogni schema di alimentazione enumerato, la funzione di callback viene chiamata con i parametri seguenti:


typedef BOOLEAN (CALLBACK* PWRSCHEMESENUMPROC)(
  UINT uiIndex,      // power scheme index
  DWORD dwName,      // size of the sName string, in bytes
  LPWSTR sName,      // name of the power scheme
  DWORD dwDesc,      // size of the sDesc string, in bytes
  LPWSTR sDesc,      // description string
  PPOWER_POLICY pp,  // receives the power policy
  LPARAM lParam      // user-defined value
);

I parametri sName e sDesc sono stringhe Unicode con terminazione null. Il parametro pp è un puntatore a una struttura POWER_POLICY contenente lo schema di power policy. Per continuare fino a quando non sono stati enumerati tutti gli schemi di alimentazione, la funzione di callback deve restituire TRUE. Per arrestare l'enumerazione, la funzione di callback deve restituire FALSE.

Per altre informazioni sull'uso di PowrProf.h, vedere Schemi di alimentazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	powrprof.h
Libreria	PowrProf.lib
DLL	PowrProf.dll

Vedi anche

POWER_POLICY

Funzioni di risparmio energia

Schemi di alimentazione

Condividi tramite