> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)

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

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

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

*result*   \_Out\_\
型: [XAppCaptureDiagnosticScreenshotResult\*](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)

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

### Return value

型: HRESULT

関数の結果。

## Remarks

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

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

この関数は、開発キットでのみ利用できます。リテール キットでは、この 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](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture Members](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFormatFlag](/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)\
[XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFile](/reference/system/xappcapture/structs/xappcapturescreenshotfile)


## Related topics

- [XAppCaptureDiagnosticScreenshotResult](/ja-jp/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)
- [XAppCaptureScreenshotFile](/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)
- [XAppCaptureScreenshotFormatFlag](/ja-jp/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md)
- [XAppCapture](/ja-jp/reference/system/xappcapture/xappcapture_members.md)
- [GDK 向け Unity C# API ラッパー](/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)