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

[XDisplayAcquireTimeoutDeferral](/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral)을 호출하여 이전에 획득한 화면 시간 초과 지연을 해제합니다.

## 구문

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

### 매개 변수

*handle*   \_In\_\
형식: XDisplayTimeoutDeferralHandle

닫을 화면 시간 초과 지연에 대한 핸들입니다.

### 반환 값

형식: void

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

화면 시간 초과 지연은 사용자의 조작이 없는 동안 화면이 어두워지거나 잠기거나 전원이 꺼지지 않도록 합니다. 일정 시간 동안 사용자의 조작이 없으면 화면 시간 초과가 발생합니다. 화면 시간 초과에 대응하여 장치는 디스플레이를 어둡게 하거나, 잠금 화면을 활성화하거나, 디스플레이의 전원을 끌 수 있습니다. 화면 시간 초과가 발생하기 전에 필요한 유휴 시간은 장치의 사용자 설정에 따라 다릅니다. 게임이 사용자 상호 작용을 필요로 하지 않는 활동(예: 게임 리소스 로드 또는 긴 컷신 표시)을 수행하는 경우 화면 시간 초과는 불편할 수 있습니다. 화면 시간 초과 지연을 획득하여 화면 시간 초과를 방지할 수 있습니다.

화면 시간 초과 지연을 획득하려면 먼저 [XDisplayAcquireTimeoutDeferral](/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral)을 호출하여 화면 시간 초과 지연에 대한 핸들을 획득한 다음, 더 이상 필요하지 않을 때 **XDisplayCloseTimeoutDeferralHandle**을 호출하여 핸들을 닫습니다. 게임이 포커스를 잃으면 화면 시간 초과 지연은 무시되며, 게임이 종료되면 해제됩니다.

<Note>[XDisplayAcquireTimeoutDeferral](/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral)을 사용하여 화면 시간 초과 지연 핸들을 획득하는 경우, 이 함수를 호출하여 해당 핸들을 닫아야 합니다. 여러 개의 화면 시간 초과 지연 핸들을 획득할 수 있으며, 모든 화면 시간 초과 지연 핸들이 닫힌 후에만 게임에 대한 화면 시간 초과가 활성화됩니다.</Note>

다음 예제는 [XDisplayAcquireTimeoutDeferral](/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral)을 호출하여 새 화면 시간 초과 지연 핸들을 획득한 후 긴 도입 컷신을 재생합니다. 새 핸들이 성공적으로 획득되면, 사용자의 조작이 없더라도 긴 도입 컷신이 화면 시간 초과 없이 재생될 수 있습니다. 컷신 재생이 끝난 후 이 예제는 **XDisplayCloseTimeoutDeferralHandle**을 호출하여 핸들을 닫습니다. 모든 화면 시간 초과 지연 핸들이 닫힌 후에는 사용자의 조작이 없을 때 다시 화면 시간 초과가 발생할 수 있습니다.

```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.
}
```

## 요구 사항

**헤더:** XDisplay.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

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


## Related topics

- [XDisplayAcquireTimeoutDeferral](/ko/reference/system/xdisplay/functions/xdisplayacquiretimeoutdeferral.md)
- [XDisplay](/ko/reference/system/xdisplay/xdisplay_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XUserCloseSignOutDeferralHandle](/ko/reference/system/xuser/functions/xuserclosesignoutdeferralhandle.md)
- [XSystemHandleType](/ko/reference/system/xsystem/enums/xsystemhandletype.md)