Funzione DevicePowerEnumDevices (powrprof.h)

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