Compartir a través de

Función DevicePowerEnumDevices (powrprof.h)

  • Artículo

Enumera los dispositivos del sistema que cumplen los criterios especificados.

Sintaxis

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

Parámetros

[in] QueryIndex

Índice del dispositivo solicitado. Para las llamadas iniciales, este valor debe ser cero.

[in] QueryInterpretationFlags

Criterios aplicados a los resultados de búsqueda.

Valor Significado
DEVICEPOWER_HARDWAREID
0x80000000
 Devuelve una cadena de identificador de hardware en lugar de un nombre descriptivo del dispositivo.
DEVICEPOWER_FILTER_DEVICES_PRESENT
0x20000000
 Omita los dispositivos que no están presentes actualmente en el sistema.
DEVICEPOWER_AND_OPERATION
0x40000000
 Realice una operación AND en QueryFlags.
DEVICEPOWER_FILTER_WAKEENABLED
0x08000000
 Compruebe si el dispositivo está habilitado actualmente para reactivar el sistema desde un estado de suspensión.
DEVICEPOWER_FILTER_ON_NAME
0x02000000
 Busque un dispositivo cuyo nombre coincida con la cadena pasada en pReturnBuffer y compruebe sus funcionalidades en QueryFlags.

[in] QueryFlags

Criterios de consulta.

Valor Significado
PDCAP_D0_SUPPORTED
0x00000001
 El dispositivo admite el estado de alimentación del sistema D0.
PDCAP_D1_SUPPORTED
0x00000002
 El dispositivo admite el estado de alimentación del sistema D1.
PDCAP_D2_SUPPORTED
0x00000004
 El dispositivo admite el estado de alimentación del sistema D2.
PDCAP_D3_SUPPORTED
0x00000008
 El dispositivo admite el estado de alimentación del sistema D3.
PDCAP_S0_SUPPORTED
0x00010000
 El dispositivo admite el estado de suspensión del sistema S0.
PDCAP_S1_SUPPORTED
0x00020000
 El dispositivo admite el estado de suspensión del sistema S1.
PDCAP_S2_SUPPORTED
0x00040000
 El dispositivo admite el estado de suspensión del sistema S2.
PDCAP_S3_SUPPORTED
0x00080000
 El dispositivo admite el estado de suspensión del sistema S3.
PDCAP_S4_SUPPORTED
0x01000000
 El dispositivo admite el estado de suspensión del sistema S4.
PDCAP_S5_SUPPORTED
0x02000000
 El dispositivo admite el estado de suspensión del sistema S5.
PDCAP_WAKE_FROM_D0_SUPPORTED
0x00000010
 El dispositivo admite la reactivación del estado de alimentación del sistema D0.
PDCAP_WAKE_FROM_D1_SUPPORTED
0x00000020
 El dispositivo admite la reactivación desde el estado de alimentación del sistema D1.
PDCAP_WAKE_FROM_D2_SUPPORTED
0x00000040
 El dispositivo admite la reactivación desde el estado de alimentación del sistema D2.
PDCAP_WAKE_FROM_D3_SUPPORTED
0x00000080
 El dispositivo admite la reactivación del estado de alimentación del sistema D3.
PDCAP_WAKE_FROM_S0_SUPPORTED
0x00100000
 El dispositivo admite la reactivación del estado de suspensión del sistema S0.
PDCAP_WAKE_FROM_S1_SUPPORTED
0x00200000
 El dispositivo admite la reactivación del estado de suspensión del sistema S1.
PDCAP_WAKE_FROM_S2_SUPPORTED
0x00400000
 El dispositivo admite la reactivación desde el estado de suspensión del sistema S2.
PDCAP_WAKE_FROM_S3_SUPPORTED
0x00800000
 El dispositivo admite la reactivación del estado de suspensión del sistema S3.
PDCAP_WARM_EJECT_SUPPORTED
0x00000100
 El dispositivo admite la expulsión cálida.

[out, optional] pReturnBuffer

Puntero a un búfer que recibe la información solicitada.

[in, out] pBufferSize

Tamaño, en bytes, del búfer de retorno.

Nota Si pReturnBuffer es NULL, pBufferSize se rellenará con el tamaño necesario para devolver los datos.
 

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Los valores del parámetro QueryFlags se pueden combinar para consultar los dispositivos que admiten dos o más criterios. Por ejemplo; Si PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED | se pasa como parámetro QueryFlags, la función consultará los dispositivos que admiten D3 o D1.

QueryFlags también se puede combinar con QueryInterpretationFlags establecido en DEVICEPOWER_AND_OPERATION para generar una consulta de dispositivos que admitan todos los criterios solicitados. Por ejemplo; Si PDCAP_D3_SUPPORTED PDCAP_D1_SUPPORTED | se pasa como parámetro QueryFlags y DEVICEPOWER_AND_OPERATION se pasa como parámetro QueryInterpretationFlags, la función consultará los dispositivos que admitan D3 y D1.

Ejemplos

Para obtener un ejemplo que use esta función, consulte Uso de Device Power API.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado powrprof.h
Library PowrProf.lib
Archivo DLL PowrProf.dll

Consulte también

Administración de energía de dispositivos