Skip to main content

XDisplayCloseTimeoutDeferralHandle

Libère un report de mise en veille de l’écran précédemment acquis en appelant XDisplayAcquireTimeoutDeferral.

Syntaxe

Paramètres

handle   _In_
Type : XDisplayTimeoutDeferralHandle
Handle du report de mise en veille de l’écran à fermer.

Valeur de retour

Type : void

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread soumis à des contraintes de temps. Pour plus d’informations, consultez Threads soumis à des contraintes de temps.
Un report de mise en veille de l’écran garantit que l’écran ne s’assombrira pas, ne se verrouillera pas et ne s’éteindra pas pendant l’inactivité de l’utilisateur. Après un certain temps d’inactivité, une mise en veille de l’écran se produit. En réponse à une mise en veille de l’écran, les appareils peuvent assombrir l’affichage, activer l’écran de verrouillage ou éteindre l’affichage. La durée d’inactivité requise avant la mise en veille de l’écran dépend des paramètres utilisateur de l’appareil. Si votre jeu effectue une activité qui ne nécessite pas d’interaction de l’utilisateur, comme le chargement de ressources de jeu ou l’affichage d’une longue cinématique, les mises en veille de l’écran peuvent être gênantes. Vous pouvez empêcher les mises en veille de l’écran en acquérant un report de mise en veille de l’écran. Pour acquérir un report de mise en veille de l’écran, appelez d’abord XDisplayAcquireTimeoutDeferral pour acquérir un handle pour le report de mise en veille de l’écran, puis appelez XDisplayCloseTimeoutDeferralHandle pour fermer le handle lorsqu’il n’est plus nécessaire. Les reports de mise en veille de l’écran sont ignorés si le jeu perd le focus, et ils sont libérés si le jeu se ferme.
Si vous utilisez XDisplayAcquireTimeoutDeferral pour acquérir un handle de report de mise en veille de l’écran, vous devez fermer ce handle en appelant cette fonction. Plusieurs handles de report de mise en veille de l’écran peuvent être acquis, et la mise en veille de l’écran n’est réactivée pour le jeu qu’une fois tous les handles de report de mise en veille de l’écran fermés.
L’exemple suivant lit une longue cinématique d’introduction après avoir appelé XDisplayAcquireTimeoutDeferral pour acquérir un nouveau handle de report de mise en veille de l’écran. Si le nouveau handle est acquis avec succès, la longue cinématique d’introduction peut être lue sans que l’écran se mette en veille en raison de l’inactivité de l’utilisateur. Une fois la lecture de la cinématique terminée, l’exemple appelle XDisplayCloseTimeoutDeferralHandle pour fermer le handle. Une fois tous les handles de report de mise en veille de l’écran fermés, la mise en veille de l’écran peut de nouveau se produire en raison de l’inactivité de l’utilisateur.

Configuration requise

En-tête : XDisplay.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XDisplayAcquireTimeoutDeferral
XDisplay
Last modified on October 6, 2026