VS2019 + Win10 SDK 19041 环境下的 DirectX12 入门：从零配置到画出第一个彩色三角形

VS2019 + Win10 SDK 19041 环境下的 DirectX12 实战入门：从零绘制彩色三角形全流程解析

当第一次接触DirectX12时，许多开发者都会被其复杂的初始化流程和底层API设计所困扰。与DirectX11相比，DirectX12提供了更直接的硬件控制能力，但同时也要求开发者手动管理更多细节。本文将带你从零开始，在Visual Studio 2019和Windows 10 SDK 19041环境下，一步步配置并实现一个最基本的彩色三角形渲染。

1. 开发环境准备与验证

在开始编码前，我们需要确保开发环境满足DirectX12的基本要求。首先检查显卡是否支持DirectX12功能：

dxdiag

在"显示"选项卡中查看"功能级别"，确认包含"12_x"标识。如果使用的是集成显卡，可能需要更新驱动程序或考虑使用独立显卡进行开发。

接下来安装必要的开发工具：

• Visual Studio 2019（建议使用16.11或更高版本）
• Windows 10 SDK 19041（必须精确匹配此版本）
• Git（用于获取DirectX-Headers开源库）

注意：如果已安装其他版本的Windows SDK，建议通过Visual Studio Installer单独添加19041版本，避免版本冲突。

2. 创建基础Win32项目框架

启动VS2019，选择"创建新项目"→"Windows桌面向导"，配置项目属性：

1. 在"平台工具集"中选择"Visual Studio 2019 (v142)"
2. 在"Windows SDK版本"中选择"10.0.19041.0"
3. 在"附加依赖项"中添加d3d12.lib和dxgi.lib

项目创建后，我们需要引入DirectX-Headers开源头文件。这些头文件提供了DirectX12 API的官方定义：

git clone https://github.com/microsoft/DirectX-Headers.git

将DirectX-Headers/include/directx目录添加到项目的"附加包含目录"中。这一步确保了编译器能够找到所有必要的DirectX12类型和接口定义。

3. DirectX12核心对象初始化流程

DirectX12的初始化过程涉及多个关键对象的创建，它们之间存在严格的依赖关系。以下是主要对象的创建顺序及作用：

初始化代码框架如下：

// 创建设备和命令队列 ComPtr<IDXGIFactory6> factory; ComPtr<ID3D12Device> device; ComPtr<ID3D12CommandQueue> commandQueue; // 1. 创建DXGI工厂 ThrowIfFailed(CreateDXGIFactory2(dxgiFactoryFlags, IID_PPV_ARGS(&factory))); // 2. 枚举适配器并创建设备 for (UINT adapterIndex = 0; SUCCEEDED(factory->EnumAdapterByGpuPreference(adapterIndex, DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE, IID_PPV_ARGS(&adapter))); ++adapterIndex) { if (SUCCEEDED(D3D12CreateDevice(adapter.Get(), D3D_FEATURE_LEVEL_12_0, IID_PPV_ARGS(&device)))) { break; } } // 3. 创建命令队列 D3D12_COMMAND_QUEUE_DESC queueDesc = {}; queueDesc.Type = D3D12_COMMAND_LIST_TYPE_DIRECT; ThrowIfFailed(device->CreateCommandQueue(&queueDesc, IID_PPV_ARGS(&commandQueue)));

4. 渲染管线配置与着色器编写

DirectX12的渲染管线需要显式定义所有状态，这包括顶点输入布局、着色器程序、混合状态等。我们将创建一个简单的HLSL着色器来实现彩色三角形渲染。

在项目中创建Shader.hlsl文件，内容如下：

struct VSInput { float3 position : POSITION; float4 color : COLOR; }; struct PSInput { float4 position : SV_POSITION; float4 color : COLOR; }; PSInput VSMain(VSInput input) { PSInput output; output.position = float4(input.position, 1.0f); output.color = input.color; return output; } float4 PSMain(PSInput input) : SV_TARGET { return input.color; }

然后配置管线状态对象(PSO)：

// 定义顶点输入布局 D3D12_INPUT_ELEMENT_DESC inputElementDescs[] = { { "POSITION", 0, DXGI_FORMAT_R32G32B32_FLOAT, 0, 0, D3D12_INPUT_CLASSIFICATION_PER_VERTEX_DATA, 0 }, { "COLOR", 0, DXGI_FORMAT_R32G32B32A32_FLOAT, 0, 12, D3D12_INPUT_CLASSIFICATION_PER_VERTEX_DATA, 0 } }; // 编译着色器 ComPtr<ID3DBlob> vertexShader; ComPtr<ID3DBlob> pixelShader; CompileShader(L"Shader.hlsl", "VSMain", "vs_5_0", &vertexShader); CompileShader(L"Shader.hlsl", "PSMain", "ps_5_0", &pixelShader); // 配置管线状态 D3D12_GRAPHICS_PIPELINE_STATE_DESC psoDesc = {}; psoDesc.InputLayout = { inputElementDescs, _countof(inputElementDescs) }; psoDesc.pRootSignature = rootSignature.Get(); psoDesc.VS = CD3DX12_SHADER_BYTECODE(vertexShader.Get()); psoDesc.PS = CD3DX12_SHADER_BYTECODE(pixelShader.Get()); psoDesc.RasterizerState = CD3DX12_RASTERIZER_DESC(D3D12_DEFAULT); psoDesc.BlendState = CD3DX12_BLEND_DESC(D3D12_DEFAULT); psoDesc.PrimitiveTopologyType = D3D12_PRIMITIVE_TOPOLOGY_TYPE_TRIANGLE; psoDesc.NumRenderTargets = 1; psoDesc.RTVFormats[0] = DXGI_FORMAT_R8G8B8A8_UNORM; psoDesc.SampleDesc.Count = 1; ComPtr<ID3D12PipelineState> pipelineState; ThrowIfFailed(device->CreateGraphicsPipelineState(&psoDesc, IID_PPV_ARGS(&pipelineState)));

5. 资源上传与渲染循环实现

DirectX12要求开发者显式管理资源的上传和状态转换。我们需要创建顶点缓冲区并上传三角形数据：

// 定义顶点数据结构 struct Vertex { XMFLOAT3 position; XMFLOAT4 color; }; // 三角形顶点数据 Vertex triangleVertices[] = { { { -0.5f, -0.5f, 0.0f }, { 1.0f, 0.0f, 0.0f, 1.0f } }, // 左下，红色 { { 0.0f, 0.5f, 0.0f }, { 0.0f, 1.0f, 0.0f, 1.0f } }, // 顶部，绿色 { { 0.5f, -0.5f, 0.0f }, { 0.0f, 0.0f, 1.0f, 1.0f } } // 右下，蓝色 }; // 创建上传堆并复制数据 ComPtr<ID3D12Resource> vertexBuffer; D3D12_VERTEX_BUFFER_VIEW vertexBufferView; const UINT vertexBufferSize = sizeof(triangleVertices); ThrowIfFailed(device->CreateCommittedResource( &CD3DX12_HEAP_PROPERTIES(D3D12_HEAP_TYPE_UPLOAD), D3D12_HEAP_FLAG_NONE, &CD3DX12_RESOURCE_DESC::Buffer(vertexBufferSize), D3D12_RESOURCE_STATE_GENERIC_READ, nullptr, IID_PPV_ARGS(&vertexBuffer))); // 映射内存并复制数据 void* pVertexDataBegin; CD3DX12_RANGE readRange(0, 0); ThrowIfFailed(vertexBuffer->Map(0, &readRange, &pVertexDataBegin)); memcpy(pVertexDataBegin, triangleVertices, vertexBufferSize); vertexBuffer->Unmap(0, nullptr); // 初始化顶点缓冲区视图 vertexBufferView.BufferLocation = vertexBuffer->GetGPUVirtualAddress(); vertexBufferView.StrideInBytes = sizeof(Vertex); vertexBufferView.SizeInBytes = vertexBufferSize;

渲染循环的实现需要正确处理帧同步和命令提交：

void RenderFrame() { // 重置命令分配器和命令列表 ThrowIfFailed(commandAllocator->Reset()); ThrowIfFailed(commandList->Reset(commandAllocator.Get(), pipelineState.Get())); // 设置视口和裁剪矩形 commandList->RSSetViewports(1, &viewport); commandList->RSSetScissorRects(1, &scissorRect); // 资源屏障：从呈现状态转换为渲染目标状态 CD3DX12_RESOURCE_BARRIER barrier = CD3DX12_RESOURCE_BARRIER::Transition( renderTargets[frameIndex].Get(), D3D12_RESOURCE_STATE_PRESENT, D3D12_RESOURCE_STATE_RENDER_TARGET); commandList->ResourceBarrier(1, &barrier); // 获取当前RTV并清除 CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle( rtvHeap->GetCPUDescriptorHandleForHeapStart(), frameIndex, rtvDescriptorSize); const float clearColor[] = { 0.0f, 0.2f, 0.4f, 1.0f }; commandList->ClearRenderTargetView(rtvHandle, clearColor, 0, nullptr); // 设置渲染目标 commandList->OMSetRenderTargets(1, &rtvHandle, FALSE, nullptr); // 绘制命令 commandList->IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_TRIANGLELIST); commandList->IASetVertexBuffers(0, 1, &vertexBufferView); commandList->DrawInstanced(3, 1, 0, 0); // 资源屏障：从渲染目标状态转换回呈现状态 barrier = CD3DX12_RESOURCE_BARRIER::Transition( renderTargets[frameIndex].Get(), D3D12_RESOURCE_STATE_RENDER_TARGET, D3D12_RESOURCE_STATE_PRESENT); commandList->ResourceBarrier(1, &barrier); // 关闭命令列表并执行 ThrowIfFailed(commandList->Close()); ID3D12CommandList* ppCommandLists[] = { commandList.Get() }; commandQueue->ExecuteCommandLists(_countof(ppCommandLists), ppCommandLists); // 呈现交换链 ThrowIfFailed(swapChain->Present(1, 0)); // 等待帧完成 WaitForPreviousFrame(); }

6. 常见问题排查与优化建议

在DirectX12开发过程中，开发者常会遇到各种问题。以下是一些常见错误及其解决方案：

1. D3D12错误：DXGI_ERROR_DEVICE_REMOVED

   • 通常由驱动程序崩溃或GPU超时引起
   • 使用device->GetDeviceRemovedReason()获取具体原因
   • 解决方案：更新显卡驱动，检查资源访问冲突

2. 验证层警告

   • 启用调试层可获取详细错误信息：

     ComPtr<ID3D12Debug> debugController; if (SUCCEEDED(D3D12GetDebugInterface(IID_PPV_ARGS(&debugController)))) { debugController->EnableDebugLayer(); }

3. 性能优化技巧

   • 使用捆绑包(Bundles)重用命令列表
   • 多线程生成命令列表
   • 合理使用描述符堆和资源屏障

提示：在开发初期，建议启用Direct3D调试层，它可以帮助捕获许多常见的API使用错误。

7. 项目结构与代码组织建议

随着DirectX12项目的复杂度增加，良好的代码组织结构变得尤为重要。以下是一个推荐的目录结构：

DirectX12Triangle/ ├── Assets/ # 资源文件 │ └── Shaders/ # HLSL着色器 ├── Inc/ # 头文件 │ ├── D3D12App.h # 主应用程序类 │ └── Utilities.h # 辅助函数 └── Src/ # 源文件 ├── D3D12App.cpp # 主实现 └── main.cpp # 程序入口

对于大型项目，考虑将DirectX12相关代码封装到单独的类中，例如：

class D3D12Renderer { public: bool Initialize(HWND hWnd, uint32_t width, uint32_t height); void Render(); void Cleanup(); private: // DirectX12对象 ComPtr<ID3D12Device> device; ComPtr<IDXGISwapChain3> swapChain; // ...其他成员变量 // 初始化方法 bool CreateDevice(); bool CreateSwapChain(HWND hWnd, uint32_t width, uint32_t height); bool CreatePipelineState(); // ...其他初始化方法 };

这种封装方式使得主程序逻辑更加清晰，也便于后续功能扩展。