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

# XAppCaptureRecordDiagnosticClip

> XAppCaptureRecordDiagnosticClip

# XAppCaptureRecordDiagnosticClip

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

## 구문

```cpp theme={null}
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\*](/reference/system/xappcapture/structs/xappcapturerecordclipresult)

결과로 녹화된 진단 클립입니다.

### 반환 값

형식: HRESULT

함수 결과입니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

이 함수를 호출해도 UI 알림은 트리거되지 않습니다. 클립은 게임에서 접근 가능한 파티션에 저장됩니다. [XAppCaptureRecordDiagnosticClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult)에는 클립에 접근하는 데 사용할 수 있는 파일 경로가 포함되어 있습니다.
XBOX에서 이 함수는 개발 키트에서만 사용할 수 있습니다. 리테일 키트에서는 이 API가 즉시 오류를 반환합니다.

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

## 요구 사항

**헤더:** 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)\
[XAppCaptureRecordDiagnosticClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult)


## Related topics

- [XAppCaptureRecordClipResult](/ko/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCapture](/ko/reference/system/xappcapture/xappcapture_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureVideoEncoding](/ko/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XAppCaptureUserRecordingResult](/ko/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)