Í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.