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)
|