Skip to main content

XAppCaptureRecordTimespan

进行 GameDVR 录制。没有 UI 提示正在进行此类录制。用户无法访问该录制。任意时刻最多可以有 2 个此类录制。一旦创建了 2 个录制,就需要调用 XAppCaptureCloseLocalStream 关闭并删除一个录制后,才能进行另一个录制。这可用于捕获过去或将来的活动。

Syntax

Parameters

startTimestamp _In_opt_
类型:const SYSTEMTIME *
开始录制的时间戳。此参数可以为 null,此时系统会自动将开始时间计算为过去的 durationInMilliseconds,录制中将包含过去的活动。 durationInMilliseconds _In_
类型:uint64_t
录制的长度(以毫秒为单位)。 result _Out_
类型:XAppCaptureLocalResult *
在函数完成时,包含捕获结果。有关如何读取生成的录制,请参阅 XAppCaptureReadLocalStream

Return value

类型:HRESULT 函数结果。 如果用户的 GameDVR 设置禁止游戏进行捕获,则该函数将返回 E_ACCESSDENIED。

Remarks

有两种方式传入 startTimestamp 参数以录制过去的活动。 第一种方式是传入 null。系统会自动计算时间戳,并录制从现在起过去 durationInMilliseconds 长的活动。
当分配的空间被填满时,较旧的剪辑将被删除以为新剪辑腾出空间。请使用 PLS(持久本地存储)、已连接存储(例如 XGameSaveXGameSaveFiles)或类似的存储系统,以在设定的时间段内保留剪辑。
在第二种方式中,你必须通过将 SYSTEMTIME 或 FILETIME 转换为 ULARGE_INTEGER、执行必要的算术运算、然后将 ULARGE_INTEGER 转换回 SYSTEMTIME,来计算所需的开始时间戳。
XAppCaptureRecordTimespan 也可以用于录制接下来 durationInMilliseconds 毫秒的活动,方法是将 startTimestamp 指定为当前系统时间。
请参阅 XAppCaptureLocalResultXAppCaptureReadLocalStream

Requirements

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

See also

XAppCapture members
最后修改于 2026年8月24日