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

從您的應用程式擷取診斷螢幕擷取畫面。

## 語法

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

### 參數

*gamescreenOnly*   \_In\_\
類型：bool

決定是否只擷取遊戲畫面。如果設定為 false，除了遊戲畫面之外，可能也會擷取到某些 UI，例如螢幕小鍵盤。

*captureFlags*   \_In\_\
類型：[XAppCaptureScreenshotFormatFlag](/zh-TW/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)

決定擷取是 SDR 還是 HDR 擷取。

*filenamePrefix*   \_In\_opt\_\
類型：char\*

所需的檔案名稱前置詞 (選用)，會附加在診斷檔案名稱的前面。

*result*   \_Out\_\
類型：[XAppCaptureDiagnosticScreenshotResult\*](/zh-TW/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)

所產生的擷取螢幕擷取畫面。

### 傳回值

類型：HRESULT

函式結果。

## 備註

<Note>在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

與 [XAppCaptureTakeScreenshot](/zh-TW/reference/system/xappcapture/functions/xappcapturetakescreenshot) 不同，呼叫此函式不會觸發 UI 通知。**XAppCaptureTakeDiagnosticScreenshot** 使用 [XAppCaptureScreenshotFormatFlag](/zh-TW/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) 來指定螢幕擷取為 SDR、HDR 或兩者皆是。不過，您仍必須在 HDR 下執行，才能進行 HDR 擷取。螢幕擷取畫面會儲存到遊戲可存取的磁碟分割。[XAppCaptureDiagnosticScreenshotResult](/zh-TW/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) 包含 [XAppCaptureScreenshotFile](/zh-TW/reference/system/xappcapture/structs/xappcapturescreenshotfile) 的陣列，每個結構都包含螢幕擷取畫面的檔案路徑。

此函式只能在開發套件上使用。在零售主機上，此 API 會立即傳回錯誤。

## 需求

**標頭：** 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 概觀](/zh-TW/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture 成員](/zh-TW/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureDiagnosticScreenshotResult](/zh-TW/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFormatFlag](/zh-TW/reference/system/xappcapture/enums/xappcapturescreenshotformatflag)\
[XAppCaptureDiagnosticScreenshotResult](/zh-TW/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult)\
[XAppCaptureScreenshotFile](/zh-TW/reference/system/xappcapture/structs/xappcapturescreenshotfile)


## Related topics

- [XAppCaptureTakeDiagnosticScreenshot](/zh-CN/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)
- [XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult.md)