> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XDisplayCloseTimeoutDeferralHandle

> XDisplayCloseTimeoutDeferralHandle

# XDisplayCloseTimeoutDeferralHandle

Libera um adiamento do tempo limite da tela adquirido anteriormente por meio de uma chamada a [XDisplayAcquireTimeoutDeferral](/pt-BR/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral).

## Sintaxe

```cpp theme={null}
void XDisplayCloseTimeoutDeferralHandle(  
         XDisplayTimeoutDeferralHandle handle  
)  
```

### Parâmetros

*handle*   \_In\_\
Tipo: XDisplayTimeoutDeferralHandle

Um identificador do adiamento do tempo limite da tela a ser fechado.

### Valor retornado

Tipo: void

## Comentários

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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](/pt-BR/reference/system/xdisplay/functions/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.

<Note>Se você usar [XDisplayAcquireTimeoutDeferral](/pt-BR/reference/system/xdisplay/functions/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.</Note>

O exemplo a seguir reproduz uma longa cena cinemática de introdução depois de chamar [XDisplayAcquireTimeoutDeferral](/pt-BR/reference/system/xdisplay/functions/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.

```cpp theme={null}
void Game::PlayIntroCutscene()
{
    XDisplayTimeoutDeferralHandle handle;

    // Try to acquire a new timeout deferral handle.
    if (SUCCEEDED(XDisplayAcquireTimeoutDeferral(&handle)))
    {
        // The newly-opened timeout deferral handle prevents the display
        // from dimming over the game if the user goes idle.
        // 
        // At this point, the long intro cutscene can play without dimmming.
    }

    // Once the cutscene has completed playing, 
    // close the timeout deferral handle.
    XDisplayCloseTimeoutDeferralHandle(handle);

    // If there are no open timeout deferral handles, the display can
    // once again dim over the game if the user goes idle.
}
```

## 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

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XDisplayAcquireTimeoutDeferral](/pt-BR/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral)\
[XDisplay](/pt-BR/reference/system/xdisplay/xdisplay_members)


## Related topics

- [XDisplayCloseTimeoutDeferralHandle](/reference/system/xdisplay/functions/xdisplayclosetimeoutdeferralhandle.md)
- [XDisplayAcquireTimeoutDeferral](/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral.md)
- [XDisplay](/reference/system/xdisplay/xdisplay_members.md)