Skip to main content

XAppCaptureStartUserRecord

如同用户触发的一样进行录制。如果玩家在录制进行时挂起/约束游戏,录制将停止。录制会保存在用户分区中。捕获设置基于 GameDVR 设置。一旦达到并发录制限制,就需要调用 XAppCaptureStopUserRecordXAppCaptureCancelUserRecord 后才能开始另一个录制。此 API 的 Windows 支持将在将来的版本中添加。

Syntax

Parameters

requestingUser _In_
类型:XUserHandle
表示请求录制的用户的句柄。 localIdBufferLength _In_
类型:uint32_t
接收本地录制 ID 的缓冲区长度。 localIdBuffer _Out_
类型:char*
包含指定正在进行的录制操作的本地 ID 的缓冲区。

Return value

类型:HRESULT 函数结果。有关非 S_OK 返回值,请参阅 XAppCapture 错误代码

Remarks

在函数成功完成后,localIdOfUserRecording 包含录制的本地 ID,必须将其存储起来,以便使用 XAppCaptureStopUserRecordXAppCaptureCancelUserRecord 停止特定录制。
当分配的空间被填满时,较旧的剪辑将被删除以为新剪辑腾出空间。请使用 PLS(持久本地存储)、已连接存储(例如 XGameSaveXGameSaveFiles)或类似的存储系统,以在设定的时间段内保留剪辑。

Requirements

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

See also

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