Files
XCEngine/docs/api/XCEngine/Debug/RenderDocCapture/Shutdown.md

43 lines
864 B
Markdown
Raw Normal View History

2026-03-26 16:45:24 +08:00
# RenderDocCapture::Shutdown
2026-03-26 17:21:44 +08:00
结束抓帧并卸载 RenderDoc。
2026-03-26 16:45:24 +08:00
```cpp
void Shutdown();
```
2026-03-26 17:21:44 +08:00
## 行为说明
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
当前实现只有在 `m_initialized``true` 时才执行关闭逻辑。关闭流程包括:
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
1. 如果当前仍在抓帧,先调用 [EndCapture](EndCapture.md)。
2. 卸载 `renderdoc.dll`
3. 清空 API 指针并把 `m_isLoaded` 设为 `false`
4.`m_initialized` 设为 `false`
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
当前不会清空 `m_device``m_window` 指针,但下次 `Initialize` 会用新的参数覆盖它们。
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
## 参数
- 无。
## 返回值
- 无。
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
## 线程语义
- 建议在图形设备和窗口销毁前、主线程受控退出阶段调用。
## 示例
```cpp
XCEngine::Debug::RenderDocCapture::Get().Shutdown();
2026-03-26 16:45:24 +08:00
```
## 相关文档
2026-03-26 17:21:44 +08:00
- [返回类型总览](RenderDocCapture.md)
- [Initialize](Initialize.md)
- [EndCapture](EndCapture.md)