> ## 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.

# 屏幕捕获工具 (wdcapture.exe)

> 屏幕捕获工具 (wdcapture.exe)

使用此工具可捕获当前显示在主机输出中的任何内容的屏幕截图或视频剪辑。

<Note>
  您也可以使用 [XBOX Manager](/tools/tools-console/xbom/xbom) 工具捕获屏幕截图。
</Note>

| 命令                                  | 说明                                    |
| ----------------------------------- | ------------------------------------- |
| [screenshot](#wdcapture_screenshot) | 拍摄屏幕截图并以 PNG (SDR) 或 JXR (HDR) 文件格式保存 |
| [video]()                           | 以 MP4 文件格式录制最后若干秒的视频                  |

<a id="wdcapture_screenshot" />

## wdcapture screenshot

拍摄屏幕截图并以 PNG (SDR) 或 JXR (HDR) 文件格式保存。如果请求 HDR 屏幕截图但主机未处于 HDR 模式,则截图失败。如果指定了仅游戏画面,生成的屏幕截图将模仿零售版屏幕截图。

`wdcapture screenshot [<filename>] [hdr] [gameScreenOnly]`

| 选项               | 说明                  |
| ---------------- | ------------------- |
| `filename`       | 输出文件的名称             |
| `hdr`            | 指定应以 HDR 文件格式保存屏幕截图 |
| `gameScreenOnly` | 模仿零售版屏幕截图           |

<a id="wdcapture_video" />

## wdcapture video

以 MP4 文件格式录制最后若干秒的视频。必须指定持续时间,取值范围为 6 到 300 秒。

`wdcapture video <duration> [<filename>]`

| 选项         | 说明           |
| ---------- | ------------ |
| `duration` | 视频剪辑的持续时间(秒) |
| `filename` | 输出文件的名称      |

## 另请参阅

[基于主机的命令行工具](/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [面向 XBOX 的主机端命令行工具](/zh-CN/tools/tools-console/console_commandlinetools/index.md)
- [PC 开发的命令行工具](/zh-CN/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [XBOX Manager：媒体捕获](/zh-CN/tools/tools-console/xbom/manager-tool-media-capture.md)
- [命令行工具](/zh-CN/tools/tools-pc/commandlinetools/index.md)
- [Screen Capture (wdcapture.exe)](/zh-CN/tools/tools-pc/commandlinetools/gr-wdCapture.md)