XtfCaptureRecordedGameClip

現在実行中のゲームの GameDVR からビデオクリップを取得します。

Syntax

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	記録するフレームが見つかりませんでした。考えられる原因: 指定期間中にゲームがバックグラウンドにあった。ゲームがアクティブ化された直後に記録が要求された。
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

ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: 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