XAppCaptureTakeDiagnosticScreenshot

앱에서 진단 스크린샷을 생성합니다.

구문

HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)  

매개 변수

gamescreenOnly _In_
형식: bool

게임 화면만 캡처할지 여부를 결정합니다. false로 설정하면 게임 화면 외에 화면 키보드 같은 UI가 캡처될 수 있습니다.

captureFlags _In_
형식: XAppCaptureScreenshotFormatFlag

SDR 또는 HDR 캡처 여부를 결정합니다.

filenamePrefix _In_opt_
형식: char*

파일 이름에 사용할 접두사로, 선택 사항입니다. 진단 파일 이름 앞에 추가됩니다.

result _Out_
형식: XAppCaptureDiagnosticScreenshotResult*

결과로 캡처된 스크린샷입니다.

반환 값

형식: HRESULT

함수 결과입니다.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

XAppCaptureTakeScreenshot과 달리 이 함수를 호출해도 UI 알림이 트리거되지 않습니다. XAppCaptureTakeDiagnosticScreenshot은 XAppCaptureScreenshotFormatFlag를 사용하여 스크린 캡처가 SDR이나 HDR인지 또는 둘 다인지를 지정합니다. 하지만 HDR 캡처를 위해서는 HDR로 실행 중인 상태여야 합니다. 스크린샷은 게임에서 액세스 가능한 파티션에 저장됩니다. XAppCaptureDiagnosticScreenshotResult에는 XAppCaptureScreenshotFile의 배열이 포함되며, 각 구조에는 스크린샷에 대한 파일 경로가 포함됩니다.

이 함수는 개발 키트에서만 제공됩니다. RETAIL 키트에서 이 API는 오류를 즉시 반환합니다.

요구 사항

헤더: XAppCapture.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

GameDVR 개요
XAppCapture 멤버
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile