IDisplayRequest Interface

Represents a display request.

Syntax

public interface class IDisplayRequest  

Remarks

The system reduces power to the console if it does not detect any user activity for a certain amount of time. Depending on system power settings, the display may first be dimmed, and eventually the display may be turned off as the system enters a low-power sleep state.

Apps that show video or run for extended periods without user input can request that the display remain on by calling DisplayRequest::RequestActive. When a display request is activated, the device’s display remains on while the app is visible. When the user moves the app out of the foreground, the system deactivates the app’s display requests and reactivates them when the app returns to the foreground.

Display requests are cumulative - each display request must be released with a separate call to DisplayRequest::RequestRelease. An app should keep track of the number of active display requests and make sure all are released (each with a corresponding call to DisplayRequest::RequestRelease) when the app no longer requires the display to remain on.

Using display requests to keep the display on consumes a lot of power. Use these guidelines for best app behavior when using display requests.

• Use display requests only when required, that is, times when no user input is expected but the display should remain on.
• Release each display request as soon as it is no longer required.
• Release all display requests when the app is suspended. If the display is still required to remain on, the app can create a new display request when it is reactivated.

Requirements

Namespace: Windows.System.Display

Metadata: windows.winmd

See also

Reference

IDisplayRequest Members

Windows.System.Display Namespace