51 lines
1.1 KiB
Markdown
51 lines
1.1 KiB
Markdown
|
# OpenGLFence::Wait
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
void Wait(uint64_t timeoutNs) override;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
等待栅栏达到 signaled 状态或超时。
|
|||
|
|
|
|||
|
|
## 详细描述
|
|||
|
|
|
|||
|
|
此方法尝试等待 `m_sync`（OpenGL 同步对象）变为 signaled 状态：
|
|||
|
|
|
|||
|
|
- **未信号或无同步对象**：直接调用 `glFinish()` 阻塞 CPU，直到 GPU 完成所有命令，然后将 `m_completedValue` 更新为 `m_fenceValue`
|
|||
|
|
- **已信号状态**：调用 `glClientWaitSync()` 尝试获取同步状态，支持超时
|
|||
|
|
- **timeout = 0**：立即返回，不阻塞
|
|||
|
|
|
|||
|
|
内部使用 `GL_SYNC_FLUSH_COMMANDS_BIT` 标志确保客户端命令已刷新。
|
|||
|
|
|
|||
|
|
## 参数
|
|||
|
|
|
|||
|
|
| 参数 | 类型 | 描述 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `timeoutNs` | `uint64_t` | 超时时间，以纳秒为单位。为 `0` 时立即返回 |
|
|||
|
|
|
|||
|
|
## 返回值
|
|||
|
|
|
|||
|
|
无
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
OpenGLFence fence;
|
|||
|
|
fence.Initialize(false);
|
|||
|
|
fence.Signal();
|
|||
|
|
|
|||
|
|
// 等待最多 1 秒 (1000000000 ns)
|
|||
|
|
fence.Wait(1000000000);
|
|||
|
|
|
|||
|
|
// 等待最多 100 毫秒
|
|||
|
|
fence.Wait(100000000);
|
|||
|
|
|
|||
|
|
// timeout = 0 立即返回
|
|||
|
|
fence.Wait(0);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- [OpenGLFence 总览](fence.md) - 返回类总览
|
|||
|
|
- [Signal](signal.md) - 信号栅栏
|
|||
|
|
- [IsSignaled](is-signaled.md) - 非阻塞检查状态
|