xiner/DX12

Files

SpecialX 3fdc774f3f feat: implement D3D12 device initialization with debug layer

D3D12 Core:
- Implement complete device initialization flow
- Add debug layer enablement in DEBUG mode
- Add GPU adapter enumeration and selection
- Add feature level checking (min 11.0)
- Add DXCall and NAME_D3D12_OBJECT macros
- Add release template function
- Configure info queue for error/warning breakpoints

Documentation:
- Add changelog for D3D12 device initialization
- Update D3D12 Wiki with current implementation status
- Add Doxygen comments to Renderer and platform interface

2026-03-26 19:01:51 +08:00

3.0 KiB

Raw Blame History

变更记录：D3D12 设备初始化实现

提交日期: 2026-03-26
提交哈希: 69b7352
变更类型: 功能实现

变更概述

本次提交实现了 D3D12 设备的完整初始化流程，包括调试层、DXGI 工厂创建、GPU 适配器枚举与选择、特性级别检查和设备创建。

修改文件

Engine/Graphics/Direct3D12/

文件	变更说明
`D3D12Core.cpp`	实现完整的 D3D12 设备初始化流程
`D3D12Core.h`	添加 `release` 模板函数
`D3D12CommonHeader.h`	添加库链接、DXCall 宏、NAME_D3D12_OBJECT 宏

Engine/Graphics/

文件	变更说明
`Renderer.h`	添加 Doxygen 注释
`Renderer.cpp`	添加 Doxygen 注释
`GraphicsPlatformInterface.h`	添加 Doxygen 注释

技术要点

1. 调试层启用

#ifdef _DEBUG
{
    ComPtr<ID3D12Debug3> debug_interface;
    DXCall(D3D12GetDebugInterface(IID_PPV_ARGS(&debug_interface)));
    debug_interface->EnableDebugLayer();
    dxgi_factory_flag |= DXGI_CREATE_FACTORY_DEBUG;
}
#endif

调试层可捕获无效 API 调用和资源泄漏。

2. GPU 适配器选择

IDXGIAdapter4* determine_main_adapter()
{
    for (u32 i{ 0 }; ...; ++i)
    {
        // 按高性能优先枚举适配器
        if (SUCCEEDED(D3D12CreateDevice(adapter, minumum_feature_level, ...)))
            return adapter;
    }
    return nullptr;
}

优先选择高性能 GPU，并验证 D3D12 支持。

3. 特性级别检查

constexpr D3D_FEATURE_LEVEL feature_levels[4]{
    D3D_FEATURE_LEVEL_11_0,
    D3D_FEATURE_LEVEL_11_1,
    D3D_FEATURE_LEVEL_12_0,
    D3D_FEATURE_LEVEL_12_1,
};

获取适配器支持的最高特性级别，确保不低于最低要求 (11.0)。

4. 调试宏

// DXCall 宏 - 检查 HRESULT 并输出错误信息
#define DXCall(x) if(FAILED(x)) { ... __debugbreak(); }

// NAME_D3D12_OBJECT 宏 - 为 D3D12 对象设置调试名称
#define NAME_D3D12_OBJECT(obj, name) obj->SetName(name);

5. 信息队列配置

info_queue->SetBreakOnSeverity(D3D12_MESSAGE_SEVERITY_CORRUPTION, true);
info_queue->SetBreakOnSeverity(D3D12_MESSAGE_SEVERITY_WARNING, true);
info_queue->SetBreakOnSeverity(D3D12_MESSAGE_SEVERITY_ERROR, true);

在调试模式下，遇到警告或错误时自动断点。

初始化流程

initialize()
    │
    ├─► 启用调试层 (DEBUG 模式)
    │
    ├─► 创建 DXGI 工厂
    │
    ├─► 枚举并选择 GPU 适配器
    │       └─► 按高性能优先
    │       └─► 验证 D3D12 支持
    │
    ├─► 获取最高特性级别
    │       └─► 必须 >= 11.0
    │
    ├─► 创建 D3D12 设备
    │
    └─► 配置信息队列 (DEBUG 模式)

依赖

dxgi.lib - DXGI 库
d3d12.lib - Direct3D 12 库

后续工作

命令队列创建
交换链管理
描述符堆

3.0 KiB Raw Blame History Unescape Escape