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

# XtfCaptureRecordedGameClip

> XtfCaptureRecordedGameClip

# XtfCaptureRecordedGameClip

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

<a id="syntaxSection" />

## 语法

```cpp theme={null}
HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  
```

<a id="parametersSection" />

### 参数

*address*\
类型：PCWSTR

\[in] 主机的 IP 地址。

*fullFileName*\
类型：PCWSTR

\[in] 要写入视频的文件的完整路径和文件名。

*numSeconds*\
类型：UINT32

\[in] 要检索的视频秒数。最小值为 6 秒。最大值为 300 秒。

<a id="retvalSection" />

### 返回值

类型：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 | 目标主机上未运行标题。                                                                       |

<a id="remarksSection" />

## 备注

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

<a id="requirements" />

## 要求

**头文件：** xtfapi.h

**库：** XtfApi.lib

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

<a id="seealsoSection" />

## 另请参阅

[XtfCaptureScreenshot](/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\
[XTF 传输错误 (NDA 主题)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[其他 Xtf API](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XAppCaptureRecordClipResult](/zh-CN/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](/zh-CN/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureVideoEncoding](/zh-CN/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XtfCaptureScreenshot](/zh-CN/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)
- [XAppCapture](/zh-CN/reference/system/xappcapture/xappcapture_members.md)