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

32 lines
738 B
Markdown
Raw Normal View History

2026-03-26 16:45:24 +08:00
# TaskSystem::CreateTaskGroup
2026-03-26 20:59:59 +08:00
创建一个新的任务组对象。
2026-03-26 16:45:24 +08:00
```cpp
TaskGroup* CreateTaskGroup();
```
2026-03-26 20:59:59 +08:00
## 行为说明
2026-03-26 16:45:24 +08:00
2026-03-26 20:59:59 +08:00
当前实现会:
2026-03-26 16:45:24 +08:00
2026-03-26 20:59:59 +08:00
1. 通过 `new TaskGroup()` 分配一个任务组。
2.`m_groupMutex` 保护下把该指针加入 `m_taskGroups`
3. 返回这个裸指针。
2026-03-26 16:45:24 +08:00
2026-03-26 20:59:59 +08:00
## 返回值
2026-03-26 16:45:24 +08:00
2026-03-26 20:59:59 +08:00
- 新创建的 `TaskGroup*`
2026-03-26 16:45:24 +08:00
2026-03-26 20:59:59 +08:00
## 当前实现限制
- 当前只是在系统内部登记这个指针,并没有让任务组自动接入任务调度。
- 返回裸指针意味着所有权由调用方显式管理。
- 当前 [Shutdown](Shutdown.md) 不会自动销毁这些任务组。
2026-03-26 16:45:24 +08:00
## 相关文档
2026-03-26 20:59:59 +08:00
- [返回类型总览](TaskSystem.md)
- [TaskGroup](../TaskGroup/TaskGroup.md)
- [DestroyTaskGroup](DestroyTaskGroup.md)