Skip to main content

​
XAppCaptureTakeDiagnosticScreenshot

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

​
語法

​
參數

gamescreenOnly   _In_
類型：bool 決定是否只擷取遊戲畫面。如果設定為 false，除了遊戲畫面之外，可能也會擷取到某些 UI，例如螢幕小鍵盤。 captureFlags   _In_
類型：XAppCaptureScreenshotFormatFlag 決定擷取是 SDR 還是 HDR 擷取。 filenamePrefix   _In_opt_
類型：char* 所需的檔案名稱前置詞 (選用)，會附加在診斷檔案名稱的前面。 result   _Out_
類型：XAppCaptureDiagnosticScreenshotResult* 所產生的擷取螢幕擷取畫面。

​
傳回值

類型：HRESULT 函式結果。

​
備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感執行緒。
與 XAppCaptureTakeScreenshot 不同，呼叫此函式不會觸發 UI 通知。XAppCaptureTakeDiagnosticScreenshot 使用 XAppCaptureScreenshotFormatFlag 來指定螢幕擷取為 SDR、HDR 或兩者皆是。不過，您仍必須在 HDR 下執行，才能進行 HDR 擷取。螢幕擷取畫面會儲存到遊戲可存取的磁碟分割。XAppCaptureDiagnosticScreenshotResult 包含 XAppCaptureScreenshotFile 的陣列，每個結構都包含螢幕擷取畫面的檔案路徑。 此函式只能在開發套件上使用。在零售主機上，此 API 會立即傳回錯誤。

​
需求

標頭： XAppCapture.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

​
概念文件

​
另請參閱

GameDVR 概觀
XAppCapture 成員
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFormatFlag
XAppCaptureDiagnosticScreenshotResult
XAppCaptureScreenshotFile
Last modified on October 6, 2026