enumeración POWER_REQUEST_TYPE (wdm.h)

  • Artículo

La enumeración POWER_REQUEST_TYPE indica el tipo de solicitud de energía.

Syntax

typedef enum _POWER_REQUEST_TYPE {
  PowerRequestDisplayRequired,
  PowerRequestSystemRequired,
  PowerRequestAwayModeRequired,
  PowerRequestExecutionRequired
} POWER_REQUEST_TYPE, *PPOWER_REQUEST_TYPE;

Constantes

 
PowerRequestDisplayRequired
No lo usan los controladores. Para obtener más información, vea la sección Comentarios.
PowerRequestSystemRequired
Impide que el equipo entre automáticamente en modo de suspensión después de un período de inactividad del usuario.
PowerRequestAwayModeRequired
No lo usan los controladores. Para obtener más información, vea la sección Comentarios.
PowerRequestExecutionRequired
No lo usan los controladores. Para obtener más información, vea la sección Comentarios.

Comentarios

Esta enumeración la usan las rutinas PoClearPowerRequest y PoSetPowerRequest en modo kernel. Los controladores que llaman a estas rutinas deben especificar el valor de enumeración PowerRequestSystemRequired .

Los otros tres valores de enumeración(PowerRequestDisplayRequired, PowerRequestAwayModeRequired y PowerRequestExecutionRequired) no los usan los controladores. Las aplicaciones especifican estos tipos de solicitud de energía en llamadas a las funciones PowerSetRequest y PowerClearRequest .

Una solicitud de energía PowerRequestDisplayRequired tiene los siguientes efectos:

  • Después de un período de inactividad del usuario, la pantalla de sesión permanece activada y no se desactivará automáticamente.

  • Un protector de pantalla no se iniciará automáticamente después de un período de inactividad del usuario.

  • La sesión no se bloqueará automáticamente después de un período de inactividad del usuario. Si la sesión ya está bloqueada cuando el controlador envía la solicitud de energía, la sesión permanece bloqueada.

Se debe tomar una instancia de PowerRequestSystemRequired además de PowerRequestDisplayRequired para asegurarse de que la pantalla permanece activada y el sistema no entra en suspensión durante la solicitud.

Mientras que una solicitud de energía PowerRequestAwayModeRequired está en vigor, si el usuario intenta poner el equipo en modo de suspensión (por ejemplo, haciendo clic en Iniciar y, a continuación, haciendo clic en Suspensión), el administrador de energía desactiva el audio y el vídeo para que el equipo parezca estar en modo de suspensión, pero el equipo continúa ejecutándose. Esto solo es aplicable en sistemas de suspensión tradicional (S3).

Mientras que una solicitud de energía PowerRequestExecutionRequired está en vigor, el proceso de llamada continúa ejecutándose en lugar de suspenderse o finalizarse mediante mecanismos de administración de duración del proceso (PLM). Cuando y cuánto tiempo se permite que el proceso se ejecute depende de la configuración del sistema operativo y de la directiva de energía. Este tipo de solicitud de energía se admite a partir de Windows 8.

En los sistemas modernos en espera en la alimentación dc, las solicitudes de alimentación se finalizan después de 5 minutos.

Excepto en los sistemas PowerRequestAwayModeRequired en sistemas de suspensión tradicional (S3), las solicitudes de energía se finalizan tras la entrada de suspensión del sistema iniciada por el usuario (botón de encendido, cierre de la tapa o seleccione Suspensión en el menú Inicio).

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 7.
Encabezado wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Consulte también

PoClearPowerRequest

PoSetPowerRequest

PowerClearRequest

PowerSetRequest