Skip to main content

XAppCaptureReadScreenshotStream

读取屏幕截图流。

Syntax

Parameters

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 的字节数。

Return value

类型:HRESULT 函数结果。

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
在读取屏幕截图之前,必须使用 XAppCaptureOpenScreenShotStream 打开屏幕截图流。这将生成 handle 参数所需的 XAppCaptureScreenshotStreamHandle。然后可以调用此函数读取屏幕截图。使用 startPositionbytesToRead 参数可以读取屏幕截图的某一部分,这对于每次读取大型流的一部分很有用。可以从 XAppCaptureOpenScreenShotStreamtotalBytes 输出参数获取流的总大小。输出参数 bufferbytesWritten 有助于准确读取此函数返回的数据。读取屏幕截图数据后,使用 XAppCaptureCloseScreenshotStream 关闭屏幕截图流,以避免内存泄漏。

Requirements

头文件: XAppCapture.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

GameDVR 概述
XAppCapture Members
XAppCaptureOpenScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
最后修改于 2026年8月24日