Skip to main content

XDisplayCloseTimeoutDeferralHandle

Libera um adiamento do tempo limite da tela adquirido anteriormente por meio de uma chamada a XDisplayAcquireTimeoutDeferral.

Sintaxe

Parâmetros

handle   _In_
Tipo: XDisplayTimeoutDeferralHandle
Um identificador do adiamento do tempo limite da tela a ser fechado.

Valor retornado

Tipo: void

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Um adiamento do tempo limite da tela garante que a tela não escureça, não bloqueie nem desligue durante a inatividade do usuário. Após um determinado período ocioso, ocorre um tempo limite da tela. Em resposta a um tempo limite da tela, os dispositivos podem escurecer a tela, ativar a tela de bloqueio ou desligar a tela. O período ocioso necessário antes que ocorra o tempo limite da tela depende das configurações de usuário do dispositivo. Se o jogo estiver realizando uma atividade que não requer interação do usuário, como carregar recursos do jogo ou exibir uma cena cinemática longa, os tempos limite da tela podem ser inconvenientes. Você pode evitar os tempos limite da tela adquirindo um adiamento do tempo limite da tela. Para adquirir um adiamento do tempo limite da tela, primeiro chame XDisplayAcquireTimeoutDeferral para adquirir um identificador para o adiamento do tempo limite da tela e, em seguida, chame XDisplayCloseTimeoutDeferralHandle para fechar o identificador quando ele não for mais necessário. Os adiamentos do tempo limite da tela são ignorados se o jogo perder o foco e são liberados se o jogo for encerrado.
Se você usar XDisplayAcquireTimeoutDeferral para adquirir um identificador de adiamento do tempo limite da tela, deverá fechar esse identificador chamando esta função. É possível adquirir vários identificadores de adiamento do tempo limite da tela, e o tempo limite da tela só é habilitado para o jogo depois que todos os identificadores de adiamento do tempo limite da tela forem fechados.
O exemplo a seguir reproduz uma longa cena cinemática de introdução depois de chamar XDisplayAcquireTimeoutDeferral para adquirir um novo identificador de adiamento do tempo limite da tela. Se o novo identificador for adquirido com êxito, a longa cena cinemática de introdução poderá ser reproduzida sem que a tela atinja o tempo limite devido à inatividade do usuário. Depois que a cena cinemática termina de ser reproduzida, o exemplo chama XDisplayCloseTimeoutDeferralHandle para fechar o identificador. Depois que todos os identificadores de adiamento do tempo limite da tela forem fechados, o tempo limite da tela poderá ocorrer novamente devido à inatividade do usuário.

Requisitos

Cabeçalho: XDisplay.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XDisplayAcquireTimeoutDeferral
XDisplay
Last modified on October 6, 2026