Skip to main content

XAppCaptureOpenScreenshotStream

打开屏幕截图流。

Syntax

Parameters

localId   _In_
类型:char*
调用 XAppCaptureTakeScreenshot 之后在 XAppCaptureTakeScreenshotResult 中返回的屏幕截图本地 ID。 screenshotFormat   _In_
类型:XAppCaptureScreenshotFormatFlag
调用 XAppCaptureTakeScreenshot 之后在 XAppCaptureTakeScreenshotResult 中返回的屏幕截图格式标志。 handle   _Out_
类型:XAppCaptureScreenshotStreamHandle*
打开流后返回的屏幕截图流句柄。 totalBytes   _Out_opt_
类型:uint64_t*
流中字节的总数。

Return value

类型:HRESULT 函数结果。

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
无法从游戏分区访问屏幕截图,因此必须打开流以检索用户拍摄的或通过 XAppCaptureTakeScreenshot 拍摄的屏幕截图。XAppCaptureTakeScreenshot 会在其结果中返回 localID,此函数会使用该 ID 来检索相应的屏幕截图。只要屏幕截图保留在磁盘上,localID 就有效。主机上用于存储屏幕截图的空间有限。分配的空间用完后,较旧的屏幕截图会被删除。这可能会导致打开屏幕截图的函数无法命中某个 localID。打开流后,可以使用 XAppCaptureReadScreenShotStream 读取屏幕截图。最后,每个流都需要使用 XAppCaptureCloseScreenshotStream 关闭,以避免内存泄漏。

Requirements

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

Conceptual documentation

See also

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