> ## 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.

# XAppCaptureTakeScreenshot

> XAppCaptureTakeScreenshot

# XAppCaptureTakeScreenshot

スクリーンショットを取得します。

## Syntax

```cpp theme={null}
HRESULT XAppCaptureTakeScreenshot(  
         XUserHandle requestingUser,  
         XAppCaptureTakeScreenshotResult* result  
)  
```

### Parameters

*requestingUser*   \_In\_\
型: XUserHandle

スクリーンショットを要求しているユーザーを表すハンドル。

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

返されたスクリーンショットの結果。

### Return value

型: HRESULT

関数の結果。

## Remarks

> [!NOTE]
>
> この関数は、タイム センシティブなスレッドから呼び出しても安全ではありません。詳細については、[タイム センシティブなスレッド](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) を参照してください。\
> \[!NOTE]
> この関数は XBOX Game Streaming ではサポートされていません。サポートされているプラットフォームについては、以下の Requirements セクションを参照してください。\
> \[!NOTE]
> 新しいスクリーンショット用のスペースを確保するために、割り当てられた容量がいっぱいになると、古いスクリーンショットは削除されます。一定期間スクリーンショットを保持するには、[PLS](https://docs.xbox.com/ja-jp/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md) (Persistent Local Storage)、接続ストレージ (例: [XGameSave](https://docs.xbox.com/ja-jp/reference/system/xgamesave/xgamesave_members.md) や [XGameSaveFiles](https://docs.xbox.com/ja-jp/reference/system/xgamesavefiles/xgamesavefiles_members.md))、または同様のストレージ システムを使用してください。

**XAppCaptureTakeScreenshot** は、ユーザーがトリガーしたかのようにスクリーンショットを取得します。トーストが表示され、ゲームのスクリーンショットが保存されます。
ゲームが SDR で実行されている場合、1 つのファイルが生成されます。ゲームが HDR で実行されている場合、HDR 形式の 1 つと SDR 形式の 1 つ、計 2 つのファイルが生成されます。
スクリーンショットは、ユーザー設定に応じて XBOX Live に自動的にアップロードされる場合があります。スクリーンショットが正常に取得された後、[XAppCaptureOpenScreenShotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md) でスクリーンショット ストリームを開き、[XAppCaptureReadScreenshotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md) でスクリーンショットを読み取ることで、結果のファイルを読み取ることができます。これらの関数はどちらも、この関数から返された [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md) で返されたローカル ID を使用する必要があります。

```cpp theme={null}
XAppCaptureTakeScreenshotResult takeScreenshotResult = {0};
XUserHandle user = nullptr;
/* See XUserAddAsync, XUserAddResult on how to initialize XUserHandle */
bool hasHDR = false;

LOG_IF_FAILED(XAppCaptureTakeScreenshot(user, &takeScreenshotResult));

hasHDR = static_cast<bool>(takeScreenshotResult.availableScreenshotFormats & XAppCaptureScreenshotFormatFlag::HDR);

appLog.AddLog("LocalId %s (%s)\n", takeScreenshotResult.localId, hasHDR ? "SDR & HDR" : "SDR only");
```

## Requirements

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

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

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

## Conceptual documentation

* [タイム センシティブなスレッド](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)\
[XAppCaptureOpenScreenShotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)\
[XAppCaptureReadScreenShotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)\
[XAppCaptureCloseScreenshotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md)\
[XAppCaptureTakeScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)


## Related topics

- [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureScreenshotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureOpenScreenshotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureReadScreenshotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)
- [XAppCaptureCloseScreenshotStream](https://docs.xbox.com/ja-jp/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md)