次の方法で共有

XAppCaptureTakeDiagnosticScreenshot

  • [アーティクル]

アプリから診断スクリーンショットを取得します。

構文

HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)

パラメーター

gamescreenOnly_In_
型: bool

ゲーム画面のみをキャプチャするかどうかを決定します。 false に設定されている場合は、ゲーム画面に加えて、スクリーン キーボードなどの一部の UI をキャプチャできます。

captureFlags _In_
型: XAppCaptureScreenshotFormatFlag

キャプチャが SDR キャプチャまたは HDR キャプチャかどうかを決定します。

filenamePrefix_In_opt_
型: char*

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

result _Out_
型: XAppCaptureDiagnosticScreenshotResult*

結果のキャプチャされたスクリーンショット。

戻り値

型: HRESULT

関数の結果です。

解説

注意

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

XAppCaptureTakeScreenshotとは異なり、この関数を呼び出しても、UI 通知はトリガーされません。 XAppCaptureTakeDiagnosticScreenshot では XAppCaptureScreenshotFormatFlag を使用して、画面キャプチャが SDR か HDR またはその両方にするかどうかを指定します。 ただし、HDR キャプチャを取得するには HDR で実行している必要があります。 スクリーンショットは、ゲームでアクセス可能なパーティションに保存されます。 XAppCaptureDiagnosticScreenshotResult には XAppCaptureScreenshotFile の配列が含まれており、各構造体にはスクリーンショットへのファイル パスが含まれています。

この関数は、開発キットでのみ使用できます。 リテール キットでは、この API はすぐにエラーを返します。

要件

ヘッダー: XAppCapture.h

ライブラリ: xgameruntime.lib

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

関連項目

ゲーム録画の概要
XAppCapture のメンバー
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile