XAppCaptureRecordDiagnosticClip

从您的应用程序录制诊断剪辑。

语法

HRESULT XAppCaptureRecordDiagnosticClip(  
         time_t startTime,  
         uint32_t durationInMs,  
         const char* filenamePrefix,  
         XAppCaptureRecordClipResult* result  
)  

参数

startTime _In_
类型：time_t

开始诊断剪辑的时间戳。

durationInMs _In_
类型：uint32_t

诊断剪辑的持续时间（以毫秒为单位）。

filenamePrefix _In_opt_
类型：char*

文件名所需的前缀（可选）将附加到诊断文件名的前面。

result _Out_
类型：XAppCaptureRecordClipResult*

生成的录制诊断剪辑。

返回值

类型：HRESULT

函数结果。

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。

调用此函数不会触发 UI 通知。 剪辑保存到游戏可访问的分区。 XAppCaptureRecordDiagnosticClipResult 包含可用于访问剪贴的文件路径。 在 Xbox 上，此函数将仅适用于开发工具包。 在零售工具包中，此 API 将立即返回错误。

在电脑上，必须为应用启用后台录制，此函数才能正常工作。 执行此操作的最佳方法是按 Win+G 打开 Game Bar，然后单击“设置”图标，转到“捕获”选项卡，然后启用“玩游戏时在后台录制”。 然后，必须将应用标记为游戏。 执行此操作的最佳方法是先运行游戏。 当游戏处于焦点时，按 Win+G 打开 Game Bar，然后单击“设置”图标，转到“常规”选项卡，然后选中“记住这是一款游戏”。

要求

头文件：XAppCapture.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

GameDVR 概述
XAppCapture 成员
XAppCaptureRecordDiagnosticClipResult