다음을 통해 공유


XAppCaptureRecordDiagnosticClip

앱에서 진단 클립을 기록합니다.

구문

HRESULT XAppCaptureRecordDiagnosticClip(  
         time_t startTime,  
         uint32_t durationInMs,  
         const char* filenamePrefix,  
         XAppCaptureRecordClipResult* result  
)  

매개 변수

startTime _In_
형식: time_t

진단 클립의 시작 부분에 대한 타임스탬프입니다.

durationInMs _In_
형식: uint32_t

진단 클립의 시간 길이(밀리초)입니다.

filenamePrefix _In_opt_
형식: char*

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

result _Out_
형식: XAppCaptureRecordClipResult*

결과로 기록된 진단 클립입니다.

반환 값

형식: HRESULT

함수 결과입니다.

설명

참고 항목

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

이 함수를 호출하면 UI 알림이 트리거되지 않습니다. 클립은 게임에서 액세스 가능한 파티션에 저장됩니다. XAppCaptureRecordDiagnosticClipResult에는 클립에는 액세스하는 데 사용할 수 있는 파일 경로가 포함됩니다. Xbox에서 이 함수는 개발 키트에서만 제공됩니다. RETAIL 키트에서 이 API는 오류를 즉시 반환합니다.

PC에서 이 함수가 작동하려면 앱에 대한 백그라운드 녹음을 사용하도록 설정해야 합니다. 이 작업을 수행하는 가장 좋은 방법은 Win+G를 눌러 Game Bar를 표시한 다음 설정 아이콘을 클릭하고 캡처 탭으로 이동한 다음 "게임을 플레이하는 동안 백그라운드에서 녹화"를 사용하도록 설정하는 것입니다. 그런 다음, 앱을 게임으로 표시해야 합니다. 이 작업을 수행하는 가장 좋은 방법은 먼저 게임을 실행하는 것입니다. 게임에 포커스를 하는 동안 Win+G를 눌러 Game Bar를 표시한 다음 설정 아이콘을 클릭하고 일반 탭으로 이동하여 "게임으로 기억"을 선택합니다.

요구 사항

헤더: XAppCapture.h

라이브러리: xgameruntime.lib

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

참고 항목

GameDVR 개요
XAppCapture 멤버
XAppCaptureRecordDiagnosticClipResult