Skip to main content

XAppCaptureTakeScreenshot

截取屏幕截图。

Syntax

Parameters

requestingUser   _In_
类型:XUserHandle
表示请求屏幕截图的用户的句柄。 result   _Out_
类型:XAppCaptureTakeScreenshotResult*
返回的屏幕截图结果。

Return value

类型:HRESULT 函数结果。

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
[!NOTE] XBOX Game Streaming 不支持此函数。请参阅下面的”要求”部分了解支持它的平台。
[!NOTE] 当分配的空间被填满时,较旧的屏幕截图将被删除,以为新的屏幕截图腾出空间。请使用 PLS(持久本地存储)、已连接存储(例如 XGameSaveXGameSaveFiles)或类似的存储系统,以在设定的时间段内保留屏幕截图。
XAppCaptureTakeScreenshot 如同用户触发一样截取屏幕截图。这将显示一条通知并保存游戏屏幕截图。 如果游戏以 SDR 运行,则生成单个文件。如果游戏以 HDR 运行,则生成两个文件,一个为 HDR 格式,一个为 SDR 格式。 屏幕截图可能会根据用户偏好自动上传到 XBOX Live。屏幕截图成功截取后,可通过使用 XAppCaptureOpenScreenShotStream 打开屏幕截图流并使用 XAppCaptureReadScreenshotStream 读取屏幕截图来读取生成的文件。这两个函数都需要使用此函数返回的 XAppCaptureTakeScreenshotResult 中返回的本地 ID。

Requirements

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

Conceptual documentation

See also

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