Skip to main content

​
XAppCaptureRecordDiagnosticClip

앱에서 진단 클립을 녹화합니다.

​
구문

​
매개 변수

startTime   _In_
형식: time_t 진단 클립 시작에 대한 타임스탬프입니다. durationInMs   _In_
형식: uint32_t 진단 클립의 지속 시간(밀리초)입니다. filenamePrefix   _In_opt_
형식: char* 파일 이름에 원하는 접두사(선택 사항)로, 진단 파일 이름의 앞에 추가됩니다. result   _Out_
형식: XAppCaptureRecordClipResult* 결과로 녹화된 진단 클립입니다.

​
반환 값

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

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 함수를 호출해도 UI 알림은 트리거되지 않습니다. 클립은 게임에서 접근 가능한 파티션에 저장됩니다. XAppCaptureRecordDiagnosticClipResult에는 클립에 접근하는 데 사용할 수 있는 파일 경로가 포함되어 있습니다. XBOX에서 이 함수는 개발 키트에서만 사용할 수 있습니다. 리테일 키트에서는 이 API가 즉시 오류를 반환합니다. PC에서 이 함수가 작동하려면 앱에 대한 백그라운드 녹화를 활성화해야 합니다. 이를 수행하는 가장 좋은 방법은 Win+G를 눌러 Game Bar를 표시한 다음 설정 아이콘을 클릭하고 캡처 탭으로 이동하여 “게임을 플레이하는 동안 백그라운드에서 녹화”를 활성화하는 것입니다. 그런 다음 앱을 게임으로 표시해야 합니다. 이를 수행하는 가장 좋은 방법은 먼저 게임을 실행하는 것입니다. 게임이 포커스된 상태에서 Win+G를 눌러 Game Bar를 표시한 다음 설정 아이콘을 클릭하고 일반 탭으로 이동하여 “이것을 게임으로 기억”을 선택합니다.

​
요구 사항

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

​
개념 설명서

​
함께 보기

GameDVR 개요
XAppCapture 멤버
XAppCaptureRecordDiagnosticClipResult
마지막 수정일 2026년 8월 24일

관련 항목

XAppCaptureRecordClipResultXAppCaptureGDK용 Unity C# API 래퍼XAppCaptureVideoEncodingXAppCaptureUserRecordingResult