# RenderDocCapture::TriggerCapture

请求 RenderDoc 触发一次 capture。

```cpp
void TriggerCapture();
```

## 行为说明

如果 RenderDoc 尚未加载，当前实现直接返回。否则：

- 如果 `m_window` 非空，会先把窗口设为前台并设置焦点。
- 调用底层 `TriggerCapture()` 请求 RenderDoc 执行一次捕获。

与 [BeginCapture](BeginCapture.md) / [EndCapture](EndCapture.md) 相比，这个方法更适合交给 RenderDoc 自己决定具体捕获时机。

## 参数

- 无。

## 返回值

- 无。

## 线程语义

- 建议在拥有目标窗口焦点控制权的线程调用。

## 示例

```cpp
XCEngine::Debug::RenderDocCapture::Get().TriggerCapture();
```

## 相关文档

- [返回类型总览](RenderDocCapture.md)
- [BeginCapture](BeginCapture.md)