Files
XCEngine/docs/api/XCEngine/Debug/Profiler/MarkEvent.md

39 lines
823 B
Markdown
Raw Normal View History

2026-03-26 16:45:24 +08:00
# Profiler::MarkEvent
2026-03-26 17:21:44 +08:00
记录一个带时间戳的事件标记。
2026-03-26 16:45:24 +08:00
```cpp
void MarkEvent(const char* name, uint64_t timestamp, uint32_t threadId);
```
2026-03-26 17:21:44 +08:00
## 行为说明
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
从接口形状看,它原本应该用于把离散事件插入时间线上,但这一能力目前尚未接入内部样本系统。
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
- `name` - 事件名称。当前实现不会使用。
- `timestamp` - 事件时间戳。当前实现不会使用。
- `threadId` - 事件线程 ID。当前实现不会使用。
## 返回值
- 无。
## 线程语义
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
- 当前为空实现,无额外线程语义。
## 示例
```cpp
XCEngine::Debug::Profiler::Get().MarkEvent("GPUSubmit", 0, 0);
2026-03-26 16:45:24 +08:00
```
## 相关文档
2026-03-26 17:21:44 +08:00
- [返回类型总览](Profiler.md)
- [SetMarker](SetMarker.md)