Files
XCEngine/docs/api/XCEngine/Threading/TaskSystem/RunOnMainThread.md

32 lines
741 B
Markdown

# TaskSystem::RunOnMainThread
把一个回调排入主线程执行队列。
```cpp
void RunOnMainThread(std::function<void()>&& func);
```
## 行为说明
当前实现会在 `m_queueMutex` 保护下把回调追加到 `m_mainThreadQueue`
这些回调不会立即执行,而是等待 [Update](Update.md) 被调用时再统一消费。
## 参数
- `func` - 需要在主线程执行的回调。
## 返回值
- 无。
## 注意事项
- 当前实现本身不检查调用线程是否为主线程;“主线程”只是通过谁来调用 [Update](Update.md) 约定出来的。
- 当前没有队列容量限制,也没有通知等待主线程的机制。
## 相关文档
- [返回类型总览](TaskSystem.md)
- [Update](Update.md)