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

擷取螢幕擷取畫面。

## 語法

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

### 參數

*requestingUser*   \_In\_\
類型：XUserHandle

代表要求螢幕擷取畫面之使用者的控制代碼。

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

傳回的螢幕擷取畫面結果。

### 傳回值

類型：HRESULT

函式結果。

## 備註

> [!NOTE]
>
> 在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。\
> \[!NOTE]
> XBOX Game Streaming 不支援此函式。請參閱下方的「需求」一節，了解支援此函式的平台。\
> \[!NOTE]
> 當配置的空間填滿時，將刪除較舊的螢幕擷取畫面，為新的螢幕擷取畫面騰出空間。請使用 [PLS](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md) (Persistent Local Storage)、connected storage (例如 [XGameSave](https://docs.xbox.com/zh-TW/reference/system/xgamesave/xgamesave_members.md) 或 [XGameSaveFiles](https://docs.xbox.com/zh-TW/reference/system/xgamesavefiles/xgamesavefiles_members.md)) 或類似的儲存系統，以在設定的期間內保留螢幕擷取畫面。

**XAppCaptureTakeScreenshot** 會以如同使用者觸發的方式擷取螢幕擷取畫面。這會顯示快顯通知並儲存遊戲螢幕擷取畫面。
如果遊戲在 SDR 下執行，會產生單一檔案。如果遊戲在 HDR 下執行，會產生兩個檔案，一個為 HDR 格式，另一個為 SDR 格式。
視使用者喜好設定而定，螢幕擷取畫面可能會自動上傳至 XBOX Live。成功擷取螢幕擷取畫面後，可以使用 [XAppCaptureOpenScreenShotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md) 開啟螢幕擷取畫面資料流，並使用 [XAppCaptureReadScreenshotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md) 讀取螢幕擷取畫面，以讀取產生的檔案。這兩個函式都需要您使用此函式所傳回之 [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/zh-TW/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md) 中傳回的本機識別碼。

```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");
```

## 需求

**標頭：** XAppCapture.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[GameDVR 概觀](https://docs.xbox.com/zh-TW/build/console-features/game-dvr/gamedvr-broadcast.md)\
[XAppCapture 成員](https://docs.xbox.com/zh-TW/reference/system/xappcapture/xappcapture_members.md)\
[XAppCaptureOpenScreenShotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)\
[XAppCaptureReadScreenShotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)\
[XAppCaptureCloseScreenshotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream.md)\
[XAppCaptureTakeScreenshotResult](https://docs.xbox.com/zh-TW/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)


## Related topics

- [XAppCaptureTakeScreenshotResult](https://docs.xbox.com/zh-TW/reference/system/xappcapture/structs/xappcapturetakescreenshotresult.md)
- [XAppCaptureOpenScreenshotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream.md)
- [XAppCaptureScreenshotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureReadScreenshotStream](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturereadscreenshotstream.md)
- [XAppCaptureTakeDiagnosticScreenshot](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)