Funzione DevicePowerEnumDevices (powrprof.h)

Articolo
03/08/2023

Enumera i dispositivi nel sistema che soddisfano i criteri specificati.

Sintassi

BOOLEAN DevicePowerEnumDevices(
  [in]            ULONG  QueryIndex,
  [in]            ULONG  QueryInterpretationFlags,
  [in]            ULONG  QueryFlags,
  [out, optional] PBYTE  pReturnBuffer,
  [in, out]       PULONG pBufferSize
);

Parametri

[in] QueryIndex

Indice del dispositivo richiesto. Per le chiamate iniziali, questo valore deve essere zero.

[in] QueryInterpretationFlags

Criteri applicati ai risultati della ricerca.

Valore	Significato
DEVICEPOWER_HARDWAREID 0x80000000	Restituisce una stringa ID hardware anziché un nome descrittivo del dispositivo.
DEVICEPOWER_FILTER_DEVICES_PRESENT 0x20000000	Ignorare i dispositivi attualmente non presenti nel sistema.
DEVICEPOWER_AND_OPERATION 0x40000000	Eseguire un'operazione AND su QueryFlags.
DEVICEPOWER_FILTER_WAKEENABLED 0x08000000	Controllare se il dispositivo è attualmente abilitato per riattivare il sistema da uno stato di sospensione.
DEVICEPOWER_FILTER_ON_NAME 0x02000000	Trovare un dispositivo il cui nome corrisponde alla stringa passata in pReturnBuffer e controllarne le funzionalità in QueryFlags.

[in] QueryFlags

Criteri di query.

Valore	Significato
PDCAP_D0_SUPPORTED 0x00000001	Il dispositivo supporta lo stato di alimentazione del sistema D0.
PDCAP_D1_SUPPORTED 0x00000002	Il dispositivo supporta lo stato di alimentazione del sistema D1.
PDCAP_D2_SUPPORTED 0x00000004	Il dispositivo supporta lo stato di alimentazione del sistema D2.
PDCAP_D3_SUPPORTED 0x00000008	Il dispositivo supporta lo stato di alimentazione del sistema D3.
PDCAP_S0_SUPPORTED 0x00010000	Il dispositivo supporta lo stato di sospensione del sistema S0.
PDCAP_S1_SUPPORTED 0x00020000	Il dispositivo supporta lo stato di sospensione del sistema S1.
PDCAP_S2_SUPPORTED 0x00040000	Il dispositivo supporta lo stato di sospensione del sistema S2.
PDCAP_S3_SUPPORTED 0x00080000	Il dispositivo supporta lo stato di sospensione del sistema S3.
PDCAP_S4_SUPPORTED 0x01000000	Il dispositivo supporta lo stato di sospensione del sistema S4.
PDCAP_S5_SUPPORTED 0x02000000	Il dispositivo supporta lo stato di sospensione del sistema S5.
PDCAP_WAKE_FROM_D0_SUPPORTED 0x00000010	Il dispositivo supporta la riattivazione dallo stato di alimentazione del sistema D0.
PDCAP_WAKE_FROM_D1_SUPPORTED 0x00000020	Il dispositivo supporta la riattivazione dallo stato di alimentazione del sistema D1.
PDCAP_WAKE_FROM_D2_SUPPORTED 0x00000040	Il dispositivo supporta la riattivazione dallo stato di alimentazione del sistema D2.
PDCAP_WAKE_FROM_D3_SUPPORTED 0x00000080	Il dispositivo supporta l'riattivazione dallo stato di alimentazione del sistema D3.
PDCAP_WAKE_FROM_S0_SUPPORTED 0x00100000	Il dispositivo supporta la riattivazione dallo stato di sospensione del sistema S0.
PDCAP_WAKE_FROM_S1_SUPPORTED 0x00200000	Il dispositivo supporta la riattivazione dello stato di sospensione del sistema S1.
PDCAP_WAKE_FROM_S2_SUPPORTED 0x00400000	Il dispositivo supporta la riattivazione dello stato di sospensione del sistema S2.
PDCAP_WAKE_FROM_S3_SUPPORTED 0x00800000	Il dispositivo supporta la riattivazione dallo stato di sospensione del sistema S3.
PDCAP_WARM_EJECT_SUPPORTED 0x00000100	Il dispositivo supporta l'espulsione ad accesso frequente.

[out, optional] pReturnBuffer

Puntatore a un buffer che riceve le informazioni richieste.

[in, out] pBufferSize

Dimensione, in byte, del buffer restituito.

Nota Se pReturnBuffer è NULL, pBufferSize verrà riempito con le dimensioni necessarie per restituire i dati.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

I valori del parametro QueryFlags possono essere combinati per eseguire query per i dispositivi che supportano due o più criteri. Per esempio; se PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED | viene passato come parametro QueryFlags, la funzione eseguirà una query per i dispositivi che supportano D3 o D1.

QueryFlags può anche essere combinato con QueryInterpretationFlags impostato su DEVICEPOWER_AND_OPERATION per generare una query di dispositivi che supportano tutti i criteri richiesti. Per esempio; se PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED | viene passato come parametro QueryFlags e DEVICEPOWER_AND_OPERATION viene passato come parametro QueryInterpretationFlags, la funzione eseguirà query sui dispositivi che supportano sia D3 che D1.

Esempio

Per un esempio che usa questa funzione, vedere Uso dell'API Device Power.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	powrprof.h
Libreria	PowrProf.lib
DLL	PowrProf.dll

Vedi anche

Gestione energia dispositivo

Condividi tramite