Función GetDevicePowerState (winbase.h)
Recupera el estado de alimentación actual del dispositivo especificado. Esta función no se puede usar para consultar el estado de energía de un dispositivo de visualización.
Sintaxis
BOOL GetDevicePowerState(
[in] HANDLE hDevice,
[out] BOOL *pfOn
);
Parámetros
[in] hDevice
Identificador de un objeto en el dispositivo, como un archivo o socket, o un identificador para el propio dispositivo.
[out] pfOn
Puntero a la variable que recibe el estado de energía. Este valor es TRUE si el dispositivo está en estado de trabajo. De lo contrario, es FALSE.
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
Una aplicación puede usar GetDevicePowerState para determinar si un dispositivo está en estado de funcionamiento o un estado de bajo consumo. Si el dispositivo está en un estado de bajo consumo, el acceso al dispositivo puede provocar que se produzca una cola o se produzca un error en las solicitudes de E/S, o bien realice la transición del dispositivo al estado de trabajo. El comportamiento exacto depende de la implementación del dispositivo.
Para garantizar la máxima duración de la batería en un equipo portátil, use GetDevicePowerState para reducir el consumo de energía. Por ejemplo, si un disco está apagado actualmente, el acceso al disco hará que se ponga en marcha, lo que provocará un mayor consumo de energía y una duración reducida de la batería.
Las aplicaciones deben aplazar o limitar el acceso a los dispositivos siempre que sea posible mientras el sistema se ejecuta con batería. Para determinar si el sistema se está ejecutando en la energía de la batería y la duración restante de la batería, use la función GetSystemPowerStatus .
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |