> ## 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. # XtfCaptureRecordedGameClip > XtfCaptureRecordedGameClip # XtfCaptureRecordedGameClip 현재 실행 중인 게임의 GameDVR에서 비디오 클립을 검색합니다. ## Syntax ```cpp theme={null} HRESULT XtfCaptureRecordedGameClip( PCWSTR address, PCWSTR fullFileName, UINT32 numSeconds ) ``` ### Parameters *address*\ Type: PCWSTR \[in] 콘솔의 IP 주소입니다. *fullFileName*\ Type: PCWSTR \[in] 비디오가 기록될 파일의 전체 경로와 파일 이름입니다. *numSeconds*\ Type: UINT32 \[in] 검색할 비디오의 길이(초)입니다. 최솟값은 6초입니다. 최댓값은 300초입니다. ### Return value Type: HRESULT 성공하면 `S_OK`를 반환합니다. 그렇지 않으면 오류 코드를 반환합니다. 가능한 오류 코드는 다음과 같습니다. | Error code | Description | | ---------- | -------------------------------------------------------------------------------------------------------------------------------- | | 0x82323001 | GameDVR 서비스가 예기치 않게 종료되었습니다. | | 0x82323002 | 다른 클립을 저장할 저장 공간이 부족합니다. | | 0x82323003 | StartRecordAsync가 완료되지 않았거나, StopRecordAsync를 호출하기 전에 ApplicationClipCapture의 이 인스턴스에서 호출되지 않았습니다. | | 0x82323004 | 동시 녹화가 너무 많습니다. | | 0x82323005 | HTTP 응답 텍스트가 너무 큽니다. | | 0x82323006 | StartRecordingAsync에 대한 이전 호출 정보가 없습니다. | | 0x82323007 | StartRecordAsync 이후 할당된 시간 내에 StopRecordAsync가 호출되지 않았습니다. | | 0x82323008 | 비동기 호출이 실패했지만 오류 코드를 반환하지 않았습니다. | | 0x82323009 | 클라우드 ID를 사용할 수 없는 클라우드 클립에 대해 업데이트를 시도했습니다. | | 0x8232300A | 파일에 쓰는 중 오류가 발생했습니다. | | 0x8232300B | 녹화할 프레임을 찾을 수 없습니다. 가능한 원인은 다음과 같습니다. | | 0x8232300C | 녹화할 프레임을 찾을 수 없습니다. 가능한 원인은 다음과 같습니다. | | 0x8232300D | 클립 메타데이터의 형식이 올바르지 않습니다. | | 0x8232300E | 시작 시간이 너무 오래되었거나 미래로 너무 멀리 있습니다. | | 0x8232300F | 녹화 시간이 너무 짧거나 너무 깁니다. (6 - 300초) | | 0x82323010 | 사용자 또는 타이틀이 지정된 클립에 액세스할 수 없습니다. | | 0x82323011 | 업데이트할 필드가 없습니다. | | 0x82323012 | 요청된 기간 동안 녹화가 비활성화되었습니다. | | 0x82323013 | 다른 녹화가 진행 중인 동안 StartRecordAsync가 호출되었습니다. | | 0x82323014 | 녹화가 시작되지 않았는데 StopRecordAsync가 호출되었습니다. | | 0x82323015 | 다른 녹화가 진행 중인 동안 RecordTimespanAsync가 호출되었습니다. | | 0x82323016 | 클립을 업로드하는 데 지연이 있었습니다. 나중에 업로드를 다시 시도합니다. 게임에서는 이 오류를 안전하게 무시하거나, 요청이 아직 큐에 있지만 완료하는 데 시간이 더 걸릴 것이라는 사실을 사용자에게 알리는 데 사용할 수 있습니다. | | 0x82323017 | 실행 중인 타이틀이 없거나 타이틀에 적절한 자격 증명이 없습니다. | | 0x82323018 | 현재 타이틀이 녹화를 차단했습니다. | | 0x82323019 | 클립이 아직 클라우드에 업로드되지 않았습니다. | | 0x8232301A | 게스트 사용자가 허용되지 않는 작업에 대해 지정되었습니다. | | 0x8232301B | 방송이 진행 중이므로 GameDVR을 사용할 수 없습니다. | | 0x8C11040D | 대상 콘솔에서 타이틀이 실행 중이 아닙니다. | ## Remarks 게임이 실행되는 동안 콘솔은 최대 300초의 비디오를 FIFO 비디오 버퍼에 자동으로 저장합니다. `XtfCaptureRecordedGameClip`은 이전에 저장된 지정된 양의 비디오를 버퍼에서 검색하여 `fullFileName`에 지정된 파일에 저장합니다. 파일은 MP4 비디오 형식으로 저장됩니다. GameDVR을 사용하여 비디오 클립을 캡처하는 방법에 대한 자세한 내용은 [GameDVR and broadcasting](/build/console-features/game-dvr/gamedvr-broadcast)을 참조하세요. ## Requirements **Header:** xtfapi.h **Library:** XtfApi.lib **Supported platforms:** Windows(XBOX 콘솔 도구용) ## See also [XtfCaptureScreenshot](/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\ [XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)\ [Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi) ## Related topics - [XAppCaptureRecordClipResult](/ko/reference/system/xappcapture/structs/xappcapturerecordclipresult.md) - [XAppCaptureRecordDiagnosticClip](/ko/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md) - [XAppCaptureVideoEncoding](/ko/reference/system/xappcapture/enums/xappcapturevideoencoding.md) - [XtfCaptureScreenshot](/ko/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md) - [XAppCapture](/ko/reference/system/xappcapture/xappcapture_members.md)