XtfCaptureRecordedGameClip

从当前运行的游戏的 GameDVR 中检索视频剪辑。

语法

HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  

参数

address
类型：PCWSTR [in] 主机的 IP 地址。 fullFileName
类型：PCWSTR [in] 要写入视频的文件的完整路径和文件名。 numSeconds
类型：UINT32 [in] 要检索的视频秒数。最小值为 6 秒。最大值为 300 秒。

返回值

类型：HRESULT 成功时返回 S_OK；否则返回一个错误代码。可能的错误代码包括以下内容：

错误代码	说明
0x82323001	GameDVR 服务意外关闭。
0x82323002	没有足够的存储空间来保存另一个剪辑。
0x82323003	在调用 StopRecordAsync 之前，来自此 ApplicationClipCapture 实例的 StartRecordAsync 尚未完成或未被调用。
0x82323004	并发录制过多。
0x82323005	HTTP 响应文本过大。
0x82323006	缺少关于对 StartRecordingAsync 的先前调用的信息。
0x82323007	在 StartRecordAsync 之后未在规定的时间内调用 StopRecordAsync。
0x82323008	异步调用失败但未返回错误代码。
0x82323009	尝试对云 ID 不可用的云剪辑进行更新。
0x8232300A	写入文件时出错。
0x8232300B	未找到任何要录制的帧。可能的原因包括：游戏在指定时间段内处于后台。在游戏激活后过短时间即请求录制。
0x8232300C	未找到任何要录制的帧。可能的原因包括：游戏在指定时间段内处于后台。游戏在指定时间段内未运行。
0x8232300D	剪辑元数据格式不正确。
0x8232300E	起始时间过旧或过于遥远的未来。
0x8232300F	录制时长过短或过长。（6 - 300 秒）
0x82323010	用户或标题无权访问指定的剪辑。
0x82323011	没有可更新的字段。
0x82323012	在请求的时间段内已禁用录制。
0x82323013	在正在进行另一次录制时调用了 StartRecordAsync。
0x82323014	调用了 StopRecordAsync 但没有已开始的录制。
0x82323015	在正在进行另一次录制时调用了 RecordTimespanAsync。
0x82323016	上传剪辑时发生延迟。稍后将再次尝试上传。游戏可以安全地忽略此错误，或者用它来通知用户请求仍在队列中，但需要更多时间才能完成。
0x82323017	要么没有正在运行的标题，要么该标题没有正确的凭据。
0x82323018	当前标题已阻止录制。
0x82323019	剪辑尚未上传到云。
0x8232301A	为不允许的操作指定了访客用户。
0x8232301B	由于正在进行广播，GameDVR 不可用。
0x8C11040D	目标主机上未运行标题。

备注

游戏运行时，主机会在 FIFO 视频缓冲区中自动存储最多 300 秒的视频。XtfCaptureRecordedGameClip 从缓冲区中检索指定数量的先前存储的视频，并将其存储在 fullFileName 指定的文件中。文件以 MP4 视频格式保存。有关使用 GameDVR 捕获视频剪辑的更多信息，请参阅 GameDVR 与广播。

要求

头文件： xtfapi.h 库： XtfApi.lib 支持的平台： Windows（用于 XBOX 主机工具）

另请参阅

XtfCaptureScreenshot
XTF 传输错误 (NDA 主题)
其他 Xtf API

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XtfCaptureRecordedGameClip

XtfCaptureRecordedGameClip

语法

参数

返回值

备注

要求

另请参阅

​XtfCaptureRecordedGameClip

​语法

​参数

​返回值

​备注

​要求

​另请参阅

XtfCaptureRecordedGameClip

语法

参数

返回值

备注

要求

另请参阅