Skip to main content

XAppCaptureOpenScreenshotStream

開啟螢幕擷取畫面串流。

語法

參數

localId   _In_
類型:char*
呼叫 XAppCaptureTakeScreenshot 之後,在 XAppCaptureTakeScreenshotResult 中傳回的螢幕擷取畫面本機 ID。 screenshotFormat   _In_
類型:XAppCaptureScreenshotFormatFlag
呼叫 XAppCaptureTakeScreenshot 之後,在 XAppCaptureTakeScreenshotResult 中傳回的螢幕擷取畫面格式旗標。 handle   _Out_
類型:XAppCaptureScreenshotStreamHandle*
開啟串流後傳回的螢幕擷取畫面串流控制代碼。 totalBytes   _Out_opt_
類型:uint64_t*
串流中的位元組總數。

傳回值

類型:HRESULT 函式結果。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
無法從遊戲分割區存取螢幕擷取畫面,因此您必須開啟串流,才能擷取使用者所拍攝或使用 XAppCaptureTakeScreenshot 拍攝的螢幕擷取畫面。XAppCaptureTakeScreenshot 會在其結果中傳回 localID,此函式會使用它來擷取正確的螢幕擷取畫面。只要螢幕擷取畫面保留在磁碟上,localID 就會有效。主機上用來儲存螢幕擷取畫面的空間有限。當配置的空間已滿時,將會刪除較舊的螢幕擷取畫面。這可能會導致開啟螢幕擷取畫面函式找不到 localID。開啟串流之後,您可以使用 XAppCaptureReadScreenShotStream 讀取螢幕擷取畫面。最後,每個串流都必須使用 XAppCaptureCloseScreenshotStream 關閉,以避免記憶體流失。

需求

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

概念文件

另請參閱

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