> ## 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 からビデオ クリップを取得します。

<a id="syntaxSection" />

## Syntax

```cpp theme={null}
HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  
```

<a id="parametersSection" />

### Parameters

*address*\
型: PCWSTR

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

*fullFileName*\
型: PCWSTR

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

*numSeconds*\
型: UINT32

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

<a id="retvalSection" />

### 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 | ターゲット コンソールでタイトルが実行されていません。                                                                                             |

<a id="remarksSection" />

## Remarks

ゲームの実行中、コンソールは自動的に最大 300 秒のビデオを FIFO ビデオ バッファーに保存します。`XtfCaptureRecordedGameClip` は、以前に保存された指定量のビデオをバッファーから取得し、`fullFileName` で指定されたファイルに保存します。ファイルは MP4 ビデオ形式で保存されます。GameDVR を使用したビデオ クリップのキャプチャの詳細については、[GameDVR and broadcasting](/build/console-features/game-dvr/gamedvr-broadcast) を参照してください。

<a id="requirements" />

## Requirements

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

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

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

<a id="seealsoSection" />

## 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](/ja-jp/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](/ja-jp/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureVideoEncoding](/ja-jp/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XtfCaptureScreenshot](/ja-jp/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)
- [XtfCaptureOutputBegin](/ja-jp/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
