Skip to main content

XAppCaptureRecordDiagnosticClip

アプリから診断クリップを録画します。

構文

パラメーター

startTime   _In_
型: time_t
診断クリップの開始タイムスタンプです。 durationInMs   _In_
型: uint32_t
診断クリップの長さ (ミリ秒) です。 filenamePrefix   _In_opt_
型: char*
ファイル名の希望のプレフィックスです。任意で、診断ファイル名の先頭に追加されます。 result   _Out_
型: XAppCaptureRecordClipResult*
結果として録画される診断クリップです。

戻り値

型: HRESULT 関数の結果です。

解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。 詳細については、「Time-sensitive threads」を参照してください。
この関数を呼び出しても、UI 通知はトリガーされません。 クリップはゲームがアクセスできるパーティションに保存されます。 XAppCaptureRecordDiagnosticClipResult には、クリップへのアクセスに使用できるファイル パスが含まれています。 XBOX では、この関数は開発キットでのみ使用可能です。 小売キットでは、この API は直ちにエラーを返します。 PC では、この関数を動作させるためにアプリのバックグラウンド録画を有効にする必要があります。 これを行う最良の方法は、Win+G キーを押して Game Bar を表示し、[設定] アイコンをクリックし、[キャプチャ] タブに移動して、[ゲームのプレイ中にバックグラウンドで録画する] を有効にすることです。 次に、アプリをゲームとしてマークする必要があります。 これを行う最良の方法は、まずゲームを実行することです。 ゲームがフォーカスされている間に Win+G キーを押して Game Bar を表示し、[設定] アイコンをクリックし、[全般] タブに移動して、[これはゲームであることを覚えておく] をオンにします。

要件

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

概念ドキュメント

関連項目

GameDVR の概要
XAppCapture メンバー
XAppCaptureRecordDiagnosticClipResult
最終更新日 2026年8月24日