Skip to main content

XAppCaptureRecordTimespan

GameDVR 録画を作成します。 このような録画が行われていることを示す UI はありません。 ユーザーは録画にアクセスできません。 同時に最大 2 つのそのような録画を作成できます。 2 つの録画が作成されると、別の録画を作成する前に、XAppCaptureCloseLocalStream を呼び出して録画を閉じて削除する必要があります。 これは、過去または将来のアクティビティをキャプチャするために使用できます。

構文

パラメーター

startTimestamp _In_opt_
型: const SYSTEMTIME *
録画を開始するタイムスタンプです。 このパラメーターは null にすることができ、その場合、システムは自動的に durationInMilliseconds を過去の開始時刻として計算し、録画には過去のアクティビティが含まれます。 durationInMilliseconds _In_
型: uint64_t
録画の長さ (ミリ秒) です。 result _Out_
型: XAppCaptureLocalResult *
関数の完了時に、キャプチャ結果が含まれます。 結果の録画を読み取る方法については、XAppCaptureReadLocalStream を参照してください。

戻り値

型: HRESULT 関数の結果です。 ユーザーの GameDVR 設定でゲームによるキャプチャが禁止されている場合、この関数は E_ACCESSDENIED を返します。

解説

過去のアクティビティを録画するために startTimestamp パラメーターを渡す方法は 2 つあります。 1 つ目は、null を渡す方法です。 システムは自動的にタイムスタンプを計算し、現時点から durationInMilliseconds 分の過去のアクティビティを録画します。
割り当てられた容量がいっぱいになると、新しいクリップ用のスペースを確保するために古いクリップは削除されます。 一定期間クリップを保持するには、PLS (Persistent Local Storage)、コネクテッド ストレージ (例: XGameSave または XGameSaveFiles)、または類似のストレージ システムを使用してください。
2 つ目の方法では、SYSTEMTIME または FILETIME を ULARGE_INTEGER に変換し、必要な計算を行い、ULARGE_INTEGER を SYSTEMTIME に戻すことで、目的の開始タイムスタンプを計算する必要があります。
XAppCaptureRecordTimespan は、startTimestamp を現在のシステム時刻として指定することで、次の durationInMilliseconds ミリ秒のアクティビティを録画するためにも使用できます。
XAppCaptureLocalResult および XAppCaptureReadLocalStream を参照してください。

要件

ヘッダー: XAppCapture.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: XBOX One ファミリー本体、XBOX Series 本体

関連項目

XAppCapture メンバー
最終更新日 2026年8月24日