次の方法で共有

XtfCaptureRecordedGameClip

  • [アーティクル]

現在実行されているゲームの 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 ターゲット本体上ではタイトルが実行されていません。

解説

ゲームの実行中、本体は自動的に最大 300 秒のビデオを FIFO ビデオバッファーに保存します。 XtfCaptureRecordedGameClip は、指定された量の以前に保存されたビデオをバッファから取得し、それを fullFileName で指定されたファイルに保存します。 ファイルは MP4 ビデオ形式で保存されます。 GameDVR を使用してビデオ クリップをキャプチャする方法の詳細については、「GameDVR と配信」を参照してください。

要件

ヘッダー: xtfapi.h

ライブラリ: XtfApi.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

XtfCaptureScreenshot
XTF トランスポート エラー (NDA トピック)
その他の Xtf API