Skip to main content

XAppCaptureRecordDiagnosticClip

从应用中录制一个诊断剪辑。

Syntax

Parameters

startTime   _In_
类型:time_t
诊断剪辑开始时的时间戳。 durationInMs   _In_
类型:uint32_t
诊断剪辑的持续时间(以毫秒为单位)。 filenamePrefix   _In_opt_
类型:char*
文件名的所需前缀,可选,将附加到诊断文件名的开头。 result   _Out_
类型:XAppCaptureRecordClipResult*
生成的已录制诊断剪辑。

Return value

类型:HRESULT 函数结果。

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
调用此函数不会触发 UI 通知。剪辑保存到游戏可访问的分区。XAppCaptureRecordDiagnosticClipResult 包含一个可用于访问剪辑的文件路径。 在 XBOX 上,此函数仅在开发工具包中可用。在零售工具包上,此 API 会立即返回错误。 在 PC 上,你必须为应用启用后台录制才能使此函数正常工作。执行此操作的最佳方法是按 Win+G 调出 Game Bar,然后单击”设置”图标,转到”捕获”选项卡,并启用”当我玩游戏时在后台录制”。 然后,必须将应用标记为游戏。执行此操作的最佳方法是先运行游戏。当游戏处于焦点状态时,按 Win+G 调出 Game Bar,然后单击”设置”图标,转到”常规”选项卡,并选中”记住这是一款游戏”。

Requirements

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

Conceptual documentation

See also

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