Skip to main content

XAppCaptureTakeScreenshot

擷取螢幕擷取畫面。

語法

參數

requestingUser   _In_
類型:XUserHandle
代表要求螢幕擷取畫面之使用者的控制代碼。 result   _Out_
類型:XAppCaptureTakeScreenshotResult*
傳回的螢幕擷取畫面結果。

傳回值

類型:HRESULT 函式結果。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
[!NOTE] XBOX Game Streaming 不支援此函式。請參閱下方的「需求」一節,了解支援此函式的平台。
[!NOTE] 當配置的空間填滿時,將刪除較舊的螢幕擷取畫面,為新的螢幕擷取畫面騰出空間。請使用 PLS (Persistent Local Storage)、connected storage (例如 XGameSave 或 XGameSaveFiles) 或類似的儲存系統,以在設定的期間內保留螢幕擷取畫面。
XAppCaptureTakeScreenshot 會以如同使用者觸發的方式擷取螢幕擷取畫面。這會顯示快顯通知並儲存遊戲螢幕擷取畫面。 如果遊戲在 SDR 下執行,會產生單一檔案。如果遊戲在 HDR 下執行,會產生兩個檔案,一個為 HDR 格式,另一個為 SDR 格式。 視使用者喜好設定而定,螢幕擷取畫面可能會自動上傳至 XBOX Live。成功擷取螢幕擷取畫面後,可以使用 XAppCaptureOpenScreenShotStream 開啟螢幕擷取畫面資料流,並使用 XAppCaptureReadScreenshotStream 讀取螢幕擷取畫面,以讀取產生的檔案。這兩個函式都需要您使用此函式所傳回之 XAppCaptureTakeScreenshotResult 中傳回的本機識別碼。

需求

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

概念文件

另請參閱

GameDVR 概觀
XAppCapture 成員
XAppCaptureOpenScreenShotStream
XAppCaptureReadScreenShotStream
XAppCaptureCloseScreenshotStream
XAppCaptureTakeScreenshotResult
Last modified on October 6, 2026