현재 실행 중인 게임의 GameDVR에서 동영상 클립을 검색합니다.
구문
HRESULT XtfCaptureRecordedGameClip(
PCWSTR address,
PCWSTR fullFileName,
UINT32 numSeconds
)
매개 변수
address
형식: PCWSTR
[in] 콘솔의 도구 IP 주소입니다.
fullFileName
형식: PCWSTR
[in] 비디오를 기록할 파일의 전체 경로와 파일 이름입니다.
numSeconds
형식: UINT32
[in] 검색할 비디오의 시간(초)입니다. 최소값은 6초입니다. 최대값은 300초입니다.
반환 값
형식: HRESULT
성공한 경우 S_OK을(를) 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 가능한 오류 코드는 다음과 같습니다.
| 오류 코드 | 설명 |
|---|---|
| 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 | 타이틀이 대상 콘솔에서 실행 중이 아닙니다. |
설명
게임이 실행되는 동안 본체가 FIFO 비디오 버퍼에 최대 300초 동안 비디오를 자동으로 저장합니다.
XtfCaptureRecordedGameClip은(는) 이전에 저장된 비디오의 지정된 크기를 버퍼에서 검색하고 fullFileName에 지정된 파일에 저장합니다. 파일이 MP4 비디오 형식으로 저장되었습니다. 비디오 클립 캡처에 GameDVR을 사용하는 방법에 관한 자세한 내용은 GameDVR 및 브로드캐스팅을 참조하세요.
요구 사항
헤더: xtfapi.h
라이브러리: XtfApi.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)