Skip to main content

XDisplayCloseTimeoutDeferralHandle

Libera un aplazamiento del tiempo de espera de pantalla adquirido previamente mediante una llamada a XDisplayAcquireTimeoutDeferral.

Sintaxis

Parámetros

handle   _In_
Tipo: XDisplayTimeoutDeferralHandle
Un identificador del aplazamiento del tiempo de espera de pantalla que se va a cerrar.

Valor devuelto

Tipo: void

Comentarios

No es seguro llamar a esta función en un subproceso con dependencia temporal. Para obtener más información, consulte Subprocesos con dependencia temporal.
Un aplazamiento del tiempo de espera de pantalla garantiza que la pantalla no se atenúe, se bloquee ni se apague durante la inactividad del usuario. Después de un cierto tiempo de inactividad, se produce un tiempo de espera de pantalla. En respuesta a un tiempo de espera de pantalla, los dispositivos pueden atenuar la pantalla, activar la pantalla de bloqueo o apagar la pantalla. El tiempo de inactividad necesario para que se produzca el tiempo de espera de pantalla depende de la configuración de usuario del dispositivo. Si el juego está realizando una actividad que no requiere interacción del usuario, como cargar recursos del juego o mostrar una escena cinemática larga, los tiempos de espera de pantalla pueden resultar inconvenientes. Puede evitar los tiempos de espera de pantalla adquiriendo un aplazamiento del tiempo de espera de pantalla. Para adquirir un aplazamiento del tiempo de espera de pantalla, llame primero a XDisplayAcquireTimeoutDeferral para adquirir un identificador para el aplazamiento del tiempo de espera de pantalla y, a continuación, llame a XDisplayCloseTimeoutDeferralHandle para cerrar el identificador cuando ya no sea necesario. Los aplazamientos del tiempo de espera de pantalla se ignoran si el juego pierde el foco y se liberan si el juego se cierra.
Si usa XDisplayAcquireTimeoutDeferral para adquirir un identificador de aplazamiento del tiempo de espera de pantalla, debe cerrar ese identificador llamando a esta función. Se pueden adquirir varios identificadores de aplazamiento del tiempo de espera de pantalla, y el tiempo de espera de pantalla se habilita para el juego solo después de que se cierren todos los identificadores de aplazamiento del tiempo de espera de pantalla.
El siguiente ejemplo reproduce una escena cinemática introductoria larga después de llamar a XDisplayAcquireTimeoutDeferral para adquirir un nuevo identificador de aplazamiento del tiempo de espera de pantalla. Si el nuevo identificador se adquiere correctamente, la escena cinemática introductoria larga se puede reproducir sin que la pantalla agote el tiempo de espera debido a la inactividad del usuario. Una vez que la escena cinemática termina de reproducirse, el ejemplo llama a XDisplayCloseTimeoutDeferralHandle para cerrar el identificador. Después de que se cierren todos los identificadores de aplazamiento del tiempo de espera de pantalla, el tiempo de espera de pantalla puede volver a producirse debido a la inactividad del usuario.

Requisitos

Encabezado: XDisplay.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XDisplayAcquireTimeoutDeferral
XDisplay
Última modificación el 28 de agosto de 2026