XtfCaptureRecordedGameClip

현재 실행 중인 게임의 GameDVR에서 비디오 클립을 검색합니다.

Syntax

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을 참조하세요.

Requirements

Header: xtfapi.h Library: XtfApi.lib Supported platforms: Windows(XBOX 콘솔 도구용)

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XtfCaptureRecordedGameClip

XtfCaptureRecordedGameClip

Syntax

Parameters

Return value

Remarks

Requirements

See also

​XtfCaptureRecordedGameClip

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

XtfCaptureRecordedGameClip

Syntax

Parameters

Return value

Remarks

Requirements

See also