Passer au contenu principal

XDisplayCloseTimeoutDeferralHandle

Libère un report du délai d’expiration de l’écran acquis précédemment en appelant XDisplayAcquireTimeoutDeferral.

Syntaxe

Paramètres

handle   _In_
Type : XDisplayTimeoutDeferralHandle
Handle du report du délai d’expiration de l’écran à fermer.

Valeur de retour

Type : void

Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Un report du délai d’expiration 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é, le délai d’expiration de l’écran survient. En réponse à l’expiration du délai de l’écran, les appareils peuvent assombrir l’affichage, activer l’écran de verrouillage ou éteindre l’écran. La durée d’inactivité requise avant l’expiration du délai de l’écran dépend des paramètres utilisateur de l’appareil. Si votre jeu effectue une activité qui ne nécessite aucune interaction de l’utilisateur, comme le chargement de ressources de jeu ou l’affichage d’une longue cinématique, les expirations du délai de l’écran peuvent être gênantes. Vous pouvez empêcher ces expirations en acquérant un report du délai d’expiration de l’écran. Pour acquérir un report du délai d’expiration de l’écran, appelez d’abord XDisplayAcquireTimeoutDeferral pour acquérir un handle de report du délai d’expiration de l’écran, puis appelez XDisplayCloseTimeoutDeferralHandle pour fermer le handle lorsqu’il n’est plus nécessaire. Les reports du délai d’expiration 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 du délai d’expiration de l’écran, vous devez fermer ce handle en appelant cette fonction. Plusieurs handles de report du délai d’expiration de l’écran peuvent être acquis, et le délai d’expiration de l’écran n’est réactivé pour le jeu qu’une fois tous ces handles 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 du délai d’expiration de l’écran. Si le nouveau handle est acquis avec succès, la longue cinématique d’introduction peut être lue sans que le délai de l’écran expire 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 du délai d’expiration de l’écran fermés, le délai d’expiration de l’écran peut de nouveau survenir 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
Dernière modification le 6 octobre 2026