Skip to main content

XAppCaptureTakeScreenshot

스크린샷을 촬영합니다.

구문

매개 변수

requestingUser   _In_
형식: XUserHandle
스크린샷을 요청하는 사용자를 나타내는 핸들입니다. result   _Out_
형식: XAppCaptureTakeScreenshotResult*
반환된 스크린샷의 결과입니다.

반환 값

형식: HRESULT 함수 결과입니다.

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
[!NOTE] 이 함수는 XBOX Game Streaming에서 지원되지 않습니다. 지원되는 플랫폼을 보려면 아래 요구 사항 섹션을 참조하세요.
[!NOTE] 새 스크린샷을 위한 공간을 확보하기 위해 할당된 공간이 가득 차면 오래된 스크린샷이 삭제됩니다. 일정 기간 동안 스크린샷을 유지하려면 PLS(영구 로컬 저장소), 연결된 저장소(예: XGameSave 또는 XGameSaveFiles) 또는 유사한 저장소 시스템을 사용하세요.
XAppCaptureTakeScreenshot은 사용자가 트리거한 것처럼 스크린샷을 촬영합니다. 이는 알림을 표시하고 게임 스크린샷을 저장합니다. 게임이 SDR로 실행 중이면 단일 파일이 생성됩니다. 게임이 HDR로 실행 중이면 두 개의 파일이 생성되며, 하나는 HDR 형식이고 다른 하나는 SDR 형식입니다. 사용자 기본 설정에 따라 스크린샷이 XBOX Live에 자동으로 업로드될 수 있습니다. 스크린샷이 성공적으로 촬영되면 XAppCaptureOpenScreenShotStream으로 스크린샷 스트림을 열고 XAppCaptureReadScreenshotStream으로 스크린샷을 읽어 결과 파일을 읽을 수 있습니다. 이 두 함수 모두 이 함수에서 반환된 XAppCaptureTakeScreenshotResult에서 반환된 로컬 ID를 사용해야 합니다.

요구 사항

헤더: XAppCapture.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 설명서

함께 보기

GameDVR 개요
XAppCapture 멤버
XAppCaptureOpenScreenShotStream
XAppCaptureReadScreenShotStream
XAppCaptureCloseScreenshotStream
XAppCaptureTakeScreenshotResult
마지막 수정일 2026년 8월 24일