次の方法で共有

XAppCaptureRecordDiagnosticClip

  • [アーティクル]

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

構文

HRESULT XAppCaptureRecordDiagnosticClip(  
         time_t startTime,  
         uint32_t durationInMs,  
         const char* filenamePrefix,  
         XAppCaptureRecordClipResult* result  
)

パラメーター

startTime _In_
型: time_t

診断クリップの開始のタイムスタンプ。

durationInMs _In_
型: uint32_t

診断クリップの継続時間 (ミリ秒単位)。

filenamePrefix _In_opt_
型: char*

ファイル名の望ましいプレフィックス。省略可能。診断ファイル名の前に追加されます。

result _Out_
型: XAppCaptureRecordClipResult*

結果として録画された診断クリップ。

戻り値

型: HRESULT

関数の結果です。

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」をご覧ください。

この関数を呼び出しても、UI 通知はトリガーされません。 クリップは、ゲームでアクセス可能なパーティションに保存されます。 XAppCaptureRecordDiagnosticClipResult には、クリップにアクセスするために使用できるファイル パスが含まれています。 Xbox では、この関数は開発キットでのみ使用できます。 リテール キットでは、この API はすぐにエラーを返します。

PC でこの機能を動作させるには、アプリのバックグラウンド記録を有効にする必要があります。 これを行う最善の方法は、Win+G を押して Game Bar を起動し、[設定] アイコンをクリックして [キャプチャ] タブに移動し、[ゲームのプレイ中にバックグラウンドで記録する] を有効にすることです。 次に、アプリをゲームとしてマークする必要があります。 これを行う最善の方法は、最初にゲームを実行することです。 ゲームがフォーカスされている間に、Win+G を押してゲーム バーを表示し、[設定] アイコンをクリックして、[全般] タブに移動し、[これはゲームであることを記憶する] をオンにします。

要件

ヘッダー: XAppCapture.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

ゲーム録画の概要
XAppCapture のメンバー
XAppCaptureRecordDiagnosticClipResult