> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureTakeDiagnosticScreenshot

> XAppCaptureTakeDiagnosticScreenshot

# XAppCaptureTakeDiagnosticScreenshot

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

## Syntax

```cpp theme={null}
HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)  
```

### Parameters

*gamescreenOnly*   \_In\_\
型: bool

ゲーム画面のみをキャプチャするかどうかを決定します。false に設定すると、ゲーム画面に加えて、画面上のキーボードなどの一部の UI もキャプチャされる可能性があります。

*captureFlags*   \_In\_\
型: [XAppCaptureScreenshotFormatFlag](https://docs.xbox.com/ja-jp/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md)

キャプチャを SDR キャプチャにするか HDR キャプチャにするかを決定します。

*filenamePrefix*   \_In\_opt\_\
型: char\*

ファイル名に付ける任意のプレフィックス。省略可能で、診断ファイル名の先頭に付加されます。

*result*   \_Out\_\
型: [XAppCaptureDiagnosticScreenshotResult\*](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)

結果として得られるキャプチャされたスクリーンショット。

### Return value

型: HRESULT

関数の結果。

## Remarks

> [!NOTE]
>
> この関数は、タイム センシティブなスレッドから呼び出しても安全ではありません。詳細については、[Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) を参照してください。

[XAppCaptureTakeScreenshot](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcapturetakescreenshot.md) とは異なり、この関数を呼び出しても UI 通知はトリガーされません。**XAppCaptureTakeDiagnosticScreenshot** は、[XAppCaptureScreenshotFormatFlag](https://docs.xbox.com/ja-jp/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md) を使用して、画面キャプチャを SDR、HDR、またはその両方にするかを指定します。ただし、HDR キャプチャを取得するには、依然として HDR で実行されている必要があります。スクリーンショットは、ゲームがアクセス可能なパーティションに保存されます。[XAppCaptureDiagnosticScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md) には [XAppCaptureScreenshotFile](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotfile.md) の配列が含まれ、各構造体にはスクリーンショットのファイル パスが含まれます。

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

## Requirements

**ヘッダー:** XAppCapture.h

**ライブラリ:** xgameruntime.lib

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

## Conceptual documentation

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[GameDVR Overview](https://docs.xbox.com/ja-jp/build/console-features/game-dvr/gamedvr-broadcast.md)\
[XAppCapture Members](https://docs.xbox.com/ja-jp/reference/system/xappcapture/xappcapture_members.md)\
[XAppCaptureDiagnosticScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)\
[XAppCaptureScreenshotFormatFlag](https://docs.xbox.com/ja-jp/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md)\
[XAppCaptureDiagnosticScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)\
[XAppCaptureScreenshotFile](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)


## Related topics

- [XAppCaptureDiagnosticScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)
- [XAppCaptureScreenshotFile](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)
- [XAppCaptureScreenshotFormatFlag](https://docs.xbox.com/ja-jp/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md)
- [XAppCapture (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xappcapture/xappcapture_members.md)
- [Unity プロジェクトでの GDK API 用 C# ラッパーの使用](https://docs.xbox.com/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)