> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfCaptureRecordedGameClip

> XtfCaptureRecordedGameClip

# XtfCaptureRecordedGameClip

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

## 语法

```cpp theme={null}
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 | 未找到任何要录制的帧。可能的原因包括：<ul><li>游戏在指定时间段内处于后台。</li><li>在游戏激活后过短时间即请求录制。</li></ul> |
| 0x8232300C | 未找到任何要录制的帧。可能的原因包括：<ul><li>游戏在指定时间段内处于后台。</li><li>游戏在指定时间段内未运行。</li></ul> |
| 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 与广播](https://docs.xbox.com/zh-CN/build/console-features/game-dvr/gamedvr-broadcast.md)。

## 要求

**头文件：** xtfapi.h

**库：** XtfApi.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[XtfCaptureScreenshot](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)\
[XTF 传输错误 (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[其他 Xtf API](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [其他 Xtf API（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XAppCaptureRecordClipResult](https://docs.xbox.com/zh-CN/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [GameClip (JSON)](https://docs.xbox.com/zh-CN/reference/live/rest/json/json-gameclip.md)
- [XAppCaptureVideoEncoding](https://docs.xbox.com/zh-CN/reference/system/xappcapture/enums/xappcapturevideoencoding.md)