76 lines
2.3 KiB
Markdown
76 lines
2.3 KiB
Markdown
# D3D12Fence
|
||
|
||
## 命名空间
|
||
|
||
`XCEngine::RHI`
|
||
|
||
## 类型
|
||
|
||
类 (Class)
|
||
|
||
## 描述
|
||
|
||
D3D12Fence 是 DirectX 12 栅栏同步原语的实现类，继承自 RHIFence。该类封装了 ID3D12Fence 对象和 Win32 事件句柄，提供 GPU 与 CPU 之间的同步机制。
|
||
|
||
## 概述
|
||
|
||
D3D12Fence 通过 DirectX 12 的栅栏机制实现 GPU 命令队列的同步。每个栅栏关联一个 64 位递增数值，当 GPU 到达指定栅栏点时会更新该值，CPU 端可以等待栅栏达到目标值后继续执行。
|
||
|
||
## 公共方法表格
|
||
|
||
| 方法 | 签名 | 描述 |
|
||
|------|------|------|
|
||
| Initialize | `bool Initialize(ID3D12Device* device, uint64_t initialValue = 0)` | 初始化 D3D12Fence 对象 |
|
||
| Shutdown | `void Shutdown() override` | 释放栅栏相关资源 |
|
||
| Signal | `void Signal() override` | 使用默认值 1 触发栅栏 |
|
||
| Signal | `void Signal(uint64_t value) override` | 使用指定值触发栅栏 |
|
||
| Wait | `void Wait(uint64_t value) override` | 等待栅栏达到指定值 |
|
||
| GetCompletedValue | `uint64_t GetCompletedValue() const override` | 获取栅栏当前完成值 |
|
||
| IsSignaled | `bool IsSignaled() const override` | 检查栅栏是否已触发 |
|
||
| GetEventHandle | `void* GetEventHandle()` | 获取 Win32 事件句柄 |
|
||
| GetNativeHandle | `void* GetNativeHandle() override` | 获取底层 D3D12Fence 指针 |
|
||
| GetFence | `ID3D12Fence* GetFence() const` | 获取 ID3D12Fence 接口 |
|
||
|
||
## 使用示例
|
||
|
||
```cpp
|
||
#include "XCEngine/RHI/D3D12/D3D12Fence.h"
|
||
#include <d3d12.h>
|
||
|
||
// 创建设备后初始化栅栏
|
||
ID3D12Device* device = ...;
|
||
D3D12Fence fence;
|
||
if (!fence.Initialize(device)) {
|
||
return false;
|
||
}
|
||
|
||
// 在 GPU 命令完成后触发栅栏
|
||
fence.Signal(1);
|
||
|
||
// 在 CPU 端等待栅栏
|
||
fence.Wait(1);
|
||
|
||
// 检查栅栏状态
|
||
if (fence.IsSignaled()) {
|
||
// 栅栏已触发，可以继续执行
|
||
}
|
||
|
||
// 获取底层 D3D12Fence 进行高级操作
|
||
ID3D12Fence* nativeFence = fence.GetFence();
|
||
|
||
// 销毁前关闭
|
||
fence.Shutdown();
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [Initialize](../../fence/constructor.md)
|
||
- [Shutdown](../../fence/shutdown.md)
|
||
- [Signal](../../fence/signal.md)
|
||
- [Wait](../../fence/wait.md)
|
||
- [GetCompletedValue](../../fence/get-completed-value.md)
|
||
- [IsSignaled](../../fence/is-signaled.md)
|
||
- [GetEventHandle](get-event-handle.md)
|
||
- [GetNativeHandle](../../fence/get-native-handle.md)
|
||
- [GetFence](get-fence.md)
|