Compartir a través de


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

Vea también

GetSystemPowerStatus

Funciones de administración de energía

Estado de alimentación del sistema