Skip to main content

XAppCaptureTakeDiagnosticScreenshot

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

Syntax

Parameters

gamescreenOnly   _In_
型: bool
ゲーム画面のみをキャプチャするかどうかを決定します。false に設定すると、ゲーム画面に加えて、画面上のキーボードなどの一部の UI もキャプチャされる可能性があります。 captureFlags   _In_
型: XAppCaptureScreenshotFormatFlag
キャプチャを SDR キャプチャにするか HDR キャプチャにするかを決定します。 filenamePrefix   _In_opt_
型: char*
ファイル名に付ける任意のプレフィックス。省略可能で、診断ファイル名の先頭に付加されます。 result   _Out_
型: XAppCaptureDiagnosticScreenshotResult*
結果として得られるキャプチャされたスクリーンショット。

Return value

型: HRESULT 関数の結果。

Remarks

この関数は、タイム センシティブ スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
XAppCaptureTakeScreenshot とは異なり、この関数を呼び出しても UI 通知はトリガーされません。XAppCaptureTakeDiagnosticScreenshot は、XAppCaptureScreenshotFormatFlag を使用して、画面キャプチャを SDR、HDR、またはその両方にするかを指定します。ただし、HDR キャプチャを取得するには、依然として HDR で実行されている必要があります。スクリーンショットは、ゲームがアクセス可能なパーティションに保存されます。XAppCaptureDiagnosticScreenshotResult には XAppCaptureScreenshotFile の配列が含まれ、各構造体にはスクリーンショットのファイル パスが含まれます。 この関数は、開発キットでのみ利用できます。リテール キットでは、この API はすぐにエラーを返します。

Requirements

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

Conceptual documentation

See also

GameDVR Overview
XAppCapture Members
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile
最終更新日 2026年8月24日