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

# XAppCaptureTakeScreenshot

> XAppCaptureTakeScreenshot

# XAppCaptureTakeScreenshot

스크린샷을 촬영합니다.

## 구문

```cpp theme={null}
HRESULT XAppCaptureTakeScreenshot(  
         XUserHandle requestingUser,  
         XAppCaptureTakeScreenshotResult* result  
)  
```

### 매개 변수

*requestingUser*   \_In\_\
형식: XUserHandle

스크린샷을 요청하는 사용자를 나타내는 핸들입니다.

*result*   \_Out\_\
형식: [XAppCaptureTakeScreenshotResult\*](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)

반환된 스크린샷의 결과입니다.

### 반환 값

형식: HRESULT

함수 결과입니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.\
\[!NOTE]
이 함수는 XBOX Game Streaming에서 지원되지 않습니다. 지원되는 플랫폼을 보려면 아래 요구 사항 섹션을 참조하세요.\
\[!NOTE]
새 스크린샷을 위한 공간을 확보하기 위해 할당된 공간이 가득 차면 오래된 스크린샷이 삭제됩니다. 일정 기간 동안 스크린샷을 유지하려면 [PLS](/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)(영구 로컬 저장소), 연결된 저장소(예: [XGameSave](/reference/system/xgamesave/xgamesave_members) 또는 [XGameSaveFiles](/reference/system/xgamesavefiles/xgamesavefiles_members)) 또는 유사한 저장소 시스템을 사용하세요.</Note>

**XAppCaptureTakeScreenshot**은 사용자가 트리거한 것처럼 스크린샷을 촬영합니다. 이는 알림을 표시하고 게임 스크린샷을 저장합니다.
게임이 SDR로 실행 중이면 단일 파일이 생성됩니다. 게임이 HDR로 실행 중이면 두 개의 파일이 생성되며, 하나는 HDR 형식이고 다른 하나는 SDR 형식입니다.
사용자 기본 설정에 따라 스크린샷이 XBOX Live에 자동으로 업로드될 수 있습니다. 스크린샷이 성공적으로 촬영되면 [XAppCaptureOpenScreenShotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream)으로 스크린샷 스트림을 열고 [XAppCaptureReadScreenshotStream](/reference/system/xappcapture/functions/xappcapturereadscreenshotstream)으로 스크린샷을 읽어 결과 파일을 읽을 수 있습니다. 이 두 함수 모두 이 함수에서 반환된 [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)에서 반환된 로컬 ID를 사용해야 합니다.

```cpp theme={null}
XAppCaptureTakeScreenshotResult takeScreenshotResult = {0};
XUserHandle user = nullptr;
/* See XUserAddAsync, XUserAddResult on how to initialize XUserHandle */
bool hasHDR = false;

LOG_IF_FAILED(XAppCaptureTakeScreenshot(user, &takeScreenshotResult));

hasHDR = static_cast<bool>(takeScreenshotResult.availableScreenshotFormats & XAppCaptureScreenshotFormatFlag::HDR);

appLog.AddLog("LocalId %s (%s)\n", takeScreenshotResult.localId, hasHDR ? "SDR & HDR" : "SDR only");
```

## 요구 사항

**헤더:** XAppCapture.h

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

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 설명서

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

## 함께 보기

[GameDVR 개요](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture 멤버](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureOpenScreenShotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream)\
[XAppCaptureReadScreenShotStream](/reference/system/xappcapture/functions/xappcapturereadscreenshotstream)\
[XAppCaptureCloseScreenshotStream](/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream)\
[XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)


## Related topics

- [XAppCaptureTakeScreenshotResult](/ko/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureOpenScreenshotStream](/ko/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureScreenshotStream](/ko/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureReadScreenshotStream](/ko/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)
- [XAppCaptureCloseScreenshotStream](/ko/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md)