> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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*\
型: PCWSTR

\[in] コンソールの IP アドレスです。

*fullFileName*\
型: PCWSTR

\[in] ビデオを書き込むファイルのフル パスとファイル名です。

*numSeconds*\
型: UINT32

\[in] 取得するビデオの秒数です。最小値は 6 秒、最大値は 300 秒です。

### Return value

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は、エラー コードを返します。想定されるエラー コードは次のとおりです。

| Error code | Description |
| - | - |
| 0x82323001 | GameDVR サービスが予期せずシャットダウンしました。 |
| 0x82323002 | 別のクリップを保存するのに十分な記憶領域がありません。 |
| 0x82323003 | この ApplicationClipCapture インスタンスから StartRecordAsync が完了していない、または StopRecordAsync の呼び出しの前に StartRecordAsync が呼び出されていません。 |
| 0x82323004 | 同時録画数が多すぎます。 |
| 0x82323005 | HTTP 応答テキストが大きすぎます。 |
| 0x82323006 | 直前の StartRecordingAsync の呼び出しに関する情報が見つかりません。 |
| 0x82323007 | StartRecordAsync 後、割り当てられた時間内に StopRecordAsync が呼び出されませんでした。 |
| 0x82323008 | 非同期呼び出しは失敗しましたが、エラー コードは返されませんでした。 |
| 0x82323009 | クラウド ID が利用できないクラウド クリップに対して更新が試行されました。 |
| 0x8232300A | ファイルへの書き込み中にエラーが発生しました。 |
| 0x8232300B | 記録するフレームが見つかりませんでした。考えられる原因:<ul><li>指定期間中にゲームがバックグラウンドにあった。</li><li>ゲームがアクティブ化された直後に記録が要求された。</li></ul> |
| 0x8232300C | 記録するフレームが見つかりませんでした。考えられる原因:<ul><li>指定期間中にゲームがバックグラウンドにあった。</li><li>指定期間中にゲームが実行されていなかった。</li></ul> |
| 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](https://docs.xbox.com/ja-jp/build/console-features/game-dvr/gamedvr-broadcast.md) を参照してください。

## Requirements

**ヘッダー:** xtfapi.h

**ライブラリ:** XtfApi.lib

**サポートされているプラットフォーム:** Windows (XBOX コンソール ツール用)

## See also

[XtfCaptureScreenshot](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)\
[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [その他の Xtf API (API の内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XAppCaptureRecordClipResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [GameClip (JSON)](https://docs.xbox.com/ja-jp/reference/live/rest/json/json-gameclip.md)
- [XAppCaptureVideoEncoding](https://docs.xbox.com/ja-jp/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
