Skip to main content

XAppCaptureReadScreenshotStream

讀取螢幕擷取畫面串流。

語法

參數

handle   _In_
類型:XAppCaptureScreenshotStreamHandle
呼叫 XAppCaptureOpenScreenshotStream 所傳回的螢幕擷取畫面串流控制代碼。 startPosition   _In_
類型:uint64_t
串流中開始讀取的位置。 bytesToRead   _In_
類型:uint32_t
要從串流中讀取的位元組數。 buffer   _Out_writes_to_(bytesToRead,bytesWritten)
類型:uint8_t
用來包含 XAppCaptureReadScreenshotStream 所讀取之位元組的緩衝區。 bytesWritten   _Out_
類型:uint32_t*
實際寫入 buffer 的位元組數。

傳回值

類型:HRESULT 函式結果。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
讀取螢幕擷取畫面之前,您必須使用 XAppCaptureOpenScreenShotStream 開啟螢幕擷取畫面串流。這會產生 handle 參數所需的 XAppCaptureScreenshotStreamHandle。接著您可以呼叫此函式來讀取螢幕擷取畫面。startPosition 和 bytesToRead 參數可讓您讀取螢幕擷取畫面的一部分,這在一次讀取大型串流的一部分時很有用。您可以從 XAppCaptureOpenScreenShotStream 中的 totalBytes 輸出參數取得串流的總大小。輸出參數 buffer 和 bytesWritten 可協助您準確讀取此函式傳回的資料。讀取螢幕擷取畫面資料之後,請使用 XAppCaptureCloseScreenshotStream 關閉螢幕擷取畫面串流,以避免記憶體流失。

需求

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

概念文件

另請參閱

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