两年前我把一套DX12的旧教程从头到尾抄了一遍结果卡在三角形不出来这一步整整三天调试层一句Resource state is invalid看得我头皮发麻。后来我换了思路不再跟着那种先讲一堆D3D12对象原理、再写两千行模板代码的老路子而是按能跑起来、能看见画面、能查出问题这条线重走了一遍从Device创建、命令队列、交换链、根签名、PSO一直到顶点缓冲和贴图采样一共25个小集每集都配一段真实的调试记录。图形学里最劝退的从来不是数学而是图形API这套啰嗦到反直觉的初始化流程DX12尤其如此它把以前驱动替你做的事全推给了你好处是控制力拉满代价是任何一个描述符堆写错都会直接黑屏。这篇东西就是那25集的浓缩版写给那些想正经入门DirectX 12、又不想被过时教程带着绕远路的人也写给已经能跑通但一遇到GPU挂起就抓瞎的人。1. 为什么我建议你绕开老教程重新排一遍DX12的学习顺序1.1 老教程真正的问题不是老而是顺序错了很多人对DX12的第一印象来自那些三步走的入门文章先抄一个Win32窗口模板再塞进去一个几百行的D3D12初始化函数最后画个三角形。代码能跑但你合上教程就什么都不记得了因为它的知识组织方式是照着API文档顺序走而不是照着你的理解路径走。D3D12初始化里有十几个对象是互相依赖的要先有DXGI工厂才能枚举适配器要有适配器才能创建设备要有设备才能创建命令队列和命令分配器有了命令队列才能创建交换链并把RTV绑上去。这个依赖链如果被平铺成一段线性代码读者第一遍根本看不出谁依赖谁只能死记硬背。更麻烦的是老教程里大量使用已经被官方标记为过时的写法。比如早期文章普遍用D3D12CreateDevice直接拿默认适配器完全不考虑多显卡机器上会选到核显比如把描述符堆当成随手创建一个就行的东西而实际上描述符堆的类型、是否着色器可见、数量规划直接决定了你后面加贴图时会不会推倒重来。还有一类教程用D3DX12的老版本辅助头文件里面的一些结构体初始化宏和新版对不上你照抄之后编译能过运行时调试层会给你一堆警告。我后来总结的原则是教程的章节顺序应该跟着你在哪一步会卡住来排而不是跟着API提供了哪些函数来排。这就是这25集重排的出发点。第一集只做一件事——把调试层打开让D3D12自己的报错替你做老师第二集到第五集才碰Device交换链放到你能清屏之后再讲因为它只有在有画面输出的时候才有意义。1.2 25集这条路线是怎么切分的整条路线我按四个阶段切**骨架期第1到8集**解决能跑、能清屏、能优雅退出**管线期第9到15集**解决三角形从哪来、怎么被画出来**资源期第16到22集**解决贴图、采样器、堆上传**调试与优化期第23到25集**解决崩了怎么查、卡了怎么定位、怎么在别人的机器上不炸。这个划分有个很实际的好处每个阶段结束都有一个可验证的里程碑。骨架期结束的标志是窗口能稳定清成纯色并且点关闭不报错管线期结束的标志是屏幕上出现一个带渐变色的三角形资源期结束的标志是三角形上贴着一张你自己准备的图片调试期结束的标志是你故意写错一个资源状态能靠调试层的一句话定位到具体行号。新手最容易犯的错是跳阶段。我见过太多人第3集还没跑通就去搜DX12怎么加载贴图然后把贴图代码硬塞进一个半成品里最后得到一个全黑但有报错日志的工程。图形API是个强依赖系统每一步的输入是上一步的输出跳步带来的不是加速是把错误堆叠到无法定位。1.3 环境与工具清单别在这上面省时间我用的环境是Windows 10 21H2以上或Windows 11Visual Studio 2022工作负载勾选使用C的桌面开发Windows SDK 10.0.19041或更新。SDK版本很重要因为D3D12_FEATURE_DATA_D3D12_OPTIONS这类查询结构体在不同SDK里字段不一样用旧SDK编译新示例可能缺字段。除了基础环境这三样东西我强烈建议一开始就装好调试层D3D12 Debug Layer随SDK一起安装不需要额外下载只要在创建设备前调用D3D12GetDebugInterface并开启即可。它是DX12新手最重要的老师后面会详细讲。PIX for Windows微软官方的GPU抓帧工具能录一段帧然后逐DrawCall查看管线状态、资源内容、耗时。定位三角形不显示这类问题时它比打断点快十倍。DirectXTex处理贴图加载和Mipmap生成。DX12核心库里没有内置的Mipmap生成函数这点和DX11的D3DX11不一样自己写一份完整的DDS/PNG解码加降采样逻辑非常耗时用成熟库更划算。还有一个心态上的准备不要一开始就追求架构漂亮。我早期的工程为了面向对象把Device、SwapChain、CommandQueue都封成类结果代码量翻了三倍出问题时反而更难定位。这25集里我前8集全是平铺的过程式代码能跑通之后第9集才开始重构。先让它动起来再让它好看。2. Device初始化把调试层的眼睛先装上2.1 开启调试层与GPU验证代价与收益这是整个系列里最值钱的一步也是最多人跳过的一步。开启方式很简单#if defined(_DEBUG) ComPtrID3D12Debug debugController; if (SUCCEEDED(D3D12GetDebugInterface(IID_PPV_ARGS(debugController)))) { debugController-EnableDebugLayer(); } #endif开了之后任何资源状态错误、描述符堆越界、命令列表未关闭就提交都会在Visual Studio的输出窗口里打印一条带对象名的详细信息。我曾经因为忘了把顶点缓冲从COPY_DEST切到VERTEX_AND_CONSTANT_BUFFER调试层直接告诉我Resource barrier required before use而我如果不开调试层只会看到屏幕上什么都没有。再进一步是GPU端验证GBVComPtrID3D12Debug1 debugController1; if (SUCCEEDED(debugController-QueryInterface(IID_PPV_ARGS(debugController1)))) { debugController1-SetEnableGPUBasedValidation(TRUE); }GBV会在GPU执行阶段检查越界访问和非法状态能抓到CPU端验证漏掉的错误。但它的性能开销非常大我做实测时一个只有几百个三角形的场景开GBV后帧率掉了六成以上所以只在排查阶段开性能测试时关掉。注意调试层必须在D3D12CreateDevice之前开启设备一旦创建就无法再挂载调试层。如果你发现自己开了却没输出任何信息先检查是不是在创建设备之后才调用的。还有一个比调试层更狠的工具叫DREDDevice Removed Extended Data。GPU因为越界写、死循环、超时被系统重置时普通的GetDeviceRemovedReason只会告诉你一句DEVICE_HUNG什么线索都没有。DRED可以让你在设备被移除之后拿到出错时的自动面包屑breadcrumb和页错误地址ComPtrID3D12DeviceRemovedExtendedDataSettings dredSettings; if (SUCCEEDED(D3D12GetDebugInterface(IID_PPV_ARGS(dredSettings)))) { dredSettings-SetAutoBreadcrumbsEnablement(D3D12_DRED_ENABLEMENT_FORCED_ON); dredSettings-SetPageFaultEnablement(D3D12_DRED_ENABLEMENT_FORCED_ON); }这个设置同样要在创建设备前调用。我印象最深的一次是顶点缓冲的BufferLocation设成了空指针GPU读地址零号空间直接挂起DRED给出的页错误地址让我两分钟就定位到了那一行而在此之前我靠二分注释排查了整整一下午。2.2 枚举适配器别让核显背锅创建设备之前必须先选适配器跳过这步的后果在多显卡笔记本上特别明显——DXGI会给你返回第一个能用的而在很多机器上那就是集成显卡。你辛辛苦苦写的渲染逻辑跑在核显上帧率上不去还以为是代码效率问题。正确做法是带上GPU偏好顺序去枚举ComPtrIDXGIFactory6 factory6; CreateDXGIFactory2(0, IID_PPV_ARGS(factory6)); ComPtrIDXGIAdapter1 adapter; for (UINT i 0; factory6-EnumAdapterByGpuPreference( i, DXGI_GPU_PREFERENCE_HIGH_PERFORMANCE, IID_PPV_ARGS(adapter)) ! DXGI_ERROR_NOT_FOUND; i) { DXGI_ADAPTER_DESC1 desc{}; adapter-GetDesc1(desc); if (desc.Flags DXGI_ADAPTER_FLAG_SOFTWARE) continue; // 跳过WARP软件适配器 if (SUCCEEDED(D3D12CreateDevice(adapter.Get(), D3D_FEATURE_LEVEL_11_0, __uuidof(ID3D12Device), nullptr))) { break; // 找到第一个真正支持D3D12的硬件适配器 } adapter.Reset(); }这里有几个细节值得说。D3D12CreateDevice的最后一个参数传nullptr是一种探测用法它只检查这个适配器能不能创建设备不真的创建。这个技巧在排查为什么我的程序在别人机器上起不来时特别好用。D3D_FEATURE_LEVEL_11_0这个门槛经常被误解成DX12需要11级硬件其实D3D12要求的最低特性级就是11.0很多看起来不太新的显卡都支持。反过来玩家在论坛上抱怨directx 12 is not supported on your system这类报错绝大多数情况分三类显卡硬件确实低于11.0级系统里缺了必要的运行库或驱动过旧以及远程桌面会话下GPU不可用。作为开发者你能做的是在探测失败时给出清晰的提示而不是让程序静默黑屏。2.3 命令队列、命令分配器与围栏CPU和GPU的握手协议D3D12的执行模型和DX11最大的不同是你不再调用即执行而是录制然后提交。命令列表CommandList是一盘录像带命令分配器CommandAllocator是存放录像带的盒子命令队列CommandQueue是播放机围栏Fence是你用来知道播到第几帧了的时间戳。这个模型决定了三件事。第一命令分配器不能边录边重置你必须等到GPU把它里面录的命令执行完才能重置而执行完这个判断只能靠围栏。第二帧在途数量frame in flight决定你需要几套资源。如果你用双缓冲就需要至少两个命令分配器、两个RTV、两套上传缓冲否则你会遇到上一帧的命令还在跑这一帧就把它覆盖了的经典竞态。第三围栏的等待点如果放错位置你会看到画面撕裂或者帧率异常波动。我用的是三缓冲的配置理由后面在第4节会详细算。这里先给出围栏等待的核心写法const UINT FrameCount 3; UINT64 fenceValues[FrameCount] {}; ComPtrID3D12Fence fence; ComPtrID3D12CommandAllocator allocators[FrameCount]; HANDLE fenceEvent; // 每帧开始时 UINT currentFrame swapChain-GetCurrentBackBufferIndex(); if (fence-GetCompletedValue() fenceValues[currentFrame]) { fence-SetEventOnCompletion(fenceValues[currentFrame], fenceEvent); WaitForSingleObject(fenceEvent, INFINITE); } allocators[currentFrame]-Reset(); // 每帧提交后 const UINT64 signalValue mFrameCounter; commandQueue-Signal(fence.Get(), signalValue); fenceValues[currentFrame] signalValue;我第一次写的时候把fenceValues的索引写成了mFrameCounter % FrameCount而实际应该用GetCurrentBackBufferIndex()这两个在大多数情况下一致但在窗口resize、交换链重建之后会错位表现就是偶尔卡一帧。这种错位型bug特别难查因为它不复现于单步调试。2.4 交换链与RTV把GPU的画布接到窗口上交换链的创建有几个容易踩的参数。首先是BufferCount它必须和你的帧在途数量对上且至少为2。DX12在FLIP模型下要求BufferCount通常为3以获得更好的流畅度但我实测在大部分场景下2也能跑只是切帧的时候更容易被看到。其次是DXGI_SWAP_EFFECT_FLIP_DISCARD这个交换效果。老教程里常见的是DXGI_SWAP_EFFECT_DISCARD那个是给DX11的BITBLT模型用的在DX12里配合CreateSwapChainForHwnd会直接失败。还有SampleDesc.Count必须为1因为FLIP模型不支持多重采样交换链抗锯齿必须在渲染目标内部做。DXGI_SWAP_CHAIN_DESC1 swapChainDesc{}; swapChainDesc.BufferCount FrameCount; swapChainDesc.Width mClientWidth; swapChainDesc.Height mClientHeight; swapChainDesc.Format DXGI_FORMAT_R8G8B8A8_UNORM; swapChainDesc.BufferUsage DXGI_USAGE_RENDER_TARGET_OUTPUT; swapChainDesc.SwapEffect DXGI_SWAP_EFFECT_FLIP_DISCARD; swapChainDesc.SampleDesc.Count 1;RTV堆的创建有个小陷阱D3D12_DESCRIPTOR_HEAP_TYPE_RTV类型的堆不需要设置ShaderVisible因为渲染目标描述符只在CPU端被引用着色器看不见它。这点和后面SRV用的CBV_SRV_UAV堆正好相反后者必须ShaderVisible TRUE才能被着色器采样。把这两者的可见性搞混是我见过的最高频的低级错误之一。创建RTV本身用CreateRenderTargetView传入D3D12_RENDER_TARGET_VIEW_DESC。如果你的交换链格式和RTV格式一致可以传nullptr走默认但我建议显式写出来因为一旦你要做HDR或者不同格式的后处理默认行为会让你困惑半天。3. 从清屏到三角形管线状态到底在描述什么3.1 根签名给着色器送参数的收费标准根签名是DX12里最抽象的概念之一但换个说法就好懂了它是着色器和CPU之间的一份参数交接协议。你告诉驱动我的着色器会从这里读一个常量缓冲、从那里读一张纹理驱动据此生成最优的参数传递路径。根签名里可以放三类东西根常量32位值直接内联在命令里读取最快、根描述符直接指向某个资源省一次间接寻址、描述符表指向描述符堆里的一段范围。它们的速度和灵活度是互相矛盾的根常量最快但容量只有64个DWORD描述符表最灵活但每次都要写堆再间接读。我的经验是频繁变化且体积小的参数用根常量比如每帧的视图投影矩阵索引或者一个时间值每帧更新一次的常量缓冲用根描述符或小描述符表纹理和采样器用描述符表因为它们几乎不变一次绑定能用很久。CD3DX12_ROOT_PARAMETER1 rootParams[2]; rootParams[0].InitAsConstants(sizeof(DirectX::XMFLOAT4X4) / 4, 0); // b0 常量 rootParams[1].InitAsDescriptorTable( 1, CD3DX12_DESCRIPTOR_RANGE1( D3D12_DESCRIPTOR_RANGE_TYPE_SRV, 1, 0), // t0 纹理 D3D12_SHADER_VISIBILITY_PIXEL); CD3DX12_STATIC_SAMPLER_DESC sampler( 0, D3D12_FILTER_MIN_MAG_MIP_LINEAR, D3D12_TEXTURE_ADDRESS_MODE_WRAP, D3D12_TEXTURE_ADDRESS_MODE_WRAP, D3D12_TEXTURE_ADDRESS_MODE_WRAP); CD3DX12_VERSIONED_ROOT_SIGNATURE_DESC rootSigDesc; rootSigDesc.Init_1_1(_countof(rootParams), rootParams, 1, sampler);用Init_1_1而不是老版本Init是因为根签名1.1支持静态采样器直接写在签名里不占用描述符堆的槽位以及描述符范围标记DATA_STATIC能让驱动做更激进的优化。老教程里普遍用1.0写法虽然能跑但少了这些优化空间。3.2 PSO与输入布局一次编译多次复用管线状态对象PSO把DX11时代散落在十几个SetXXXState调用里的状态一次性打包。这个设计的好处是驱动可以在PSO创建时就完成绝大部分编译工作运行时切换只需要一次指针替换。代价是你必须把所有状态一次写全漏掉任何一项都会用默认值而默认值往往不是你想要的。创建PSO时最容易漏的是光栅化状态里的几个字段D3D12_GRAPHICS_PIPELINE_STATE_DESC psoDesc{}; psoDesc.pRootSignature mRootSignature.Get(); psoDesc.VS { vsBlob-GetBufferPointer(), vsBlob-GetBufferSize() }; psoDesc.PS { psBlob-GetBufferPointer(), psBlob-GetBufferSize() }; psoDesc.RasterizerState CD3DX12_RASTERIZER_DESC(D3D12_DEFAULT); psoDesc.RasterizerState.CullMode D3D12_CULL_MODE_NONE; // 调试期先关剔除 psoDesc.RasterizerState.FrontCounterClockwise TRUE; // 和顶点顺序一致 psoDesc.BlendState CD3DX12_BLEND_DESC(D3D12_DEFAULT); psoDesc.DepthStencilState.DepthEnable FALSE; // 先不开深度 psoDesc.PrimitiveTopologyType D3D12_PRIMITIVE_TOPOLOGY_TYPE_TRIANGLE; psoDesc.NumRenderTargets 1; psoDesc.RTVFormats[0] DXGI_FORMAT_R8G8B8A8_UNORM; psoDesc.SampleDesc.Count 1; psoDesc.SampleMask UINT_MAX;PrimitiveTopologyType这个字段我踩过坑。它是一个拓扑大类而具体的图元拓扑三角形列表、三角形带是靠在命令列表里调IASetPrimitiveTopology设置的。如果你只设了PSO里的这个字段忘了IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_TRIANGLELIST)调试层会提醒你否则就是什么都不画。RTVFormats[0]必须和交换链格式一致这个不一致导致的报错很奇怪PSO能创建成功但OMSetRenderTargets之后的绘制会被静默丢弃。3.3 顶点缓冲与上传堆三元组那些坑上传堆Upload Heap是CPU能写、GPU能读的堆类型。所有静态几何数据在初始化阶段都要先写到上传堆再通过CopyBufferRegion拷贝到默认堆Default Heap因为默认堆在GPU上访问最快但CPU不能直接映射。const UINT vertexBufferSize sizeof(Vertex) * 3; auto uploadHeapProps CD3DX12_HEAP_PROPERTIES(D3D12_HEAP_TYPE_UPLOAD); auto bufferDesc CD3DX12_RESOURCE_DESC::Buffer(vertexBufferSize); device-CreateCommittedResource( uploadHeapProps, D3D12_HEAP_FLAG_NONE, bufferDesc, D3D12_RESOURCE_STATE_GENERIC_READ, nullptr, IID_PPV_ARGS(mVertexBufferUpload));注意这里给的是D3D12_RESOURCE_STATE_GENERIC_READ而不是VERTEX_AND_CONSTANT_BUFFER。原因是上传堆的资源状态基本固定为GENERIC_READ它内部已经包含了读取语义。同理默认堆的目标资源创建时用D3D12_RESOURCE_STATE_COPY_DEST拷贝完再用一个资源屏障ResourceBarrier切换到VERTEX_AND_CONSTANT_BUFFER。那个屏障转换如果漏了调试层会给出一条很清晰的State mismatch错误。我在第6集里专门留了一个故意漏屏障的对照实验就为了让这个错误的因果关系刻进肌肉记忆。顶点缓冲视图VBV的填写有个不对齐的细节值得提D3D12_VERTEX_BUFFER_VIEW vbv{}; vbv.BufferLocation mVertexBuffer-GetGPUVirtualAddress(); vbv.StrideInBytes sizeof(Vertex); vbv.SizeInBytes vertexBufferSize;StrideInBytes如果和输入布局里的字段加起来对不上结果是顶点数据被错位解读屏幕上出现的不是三角形而是一堆拉伸的碎片。这类错误在调试器里看不出问题因为数据本身没坏只是被读错了。3.4 帧循环最小可运行的同步骨架把前面所有东西串起来的帧循环大致长这样void Render() { UINT frame mSwapChain-GetCurrentBackBufferIndex(); if (mFence-GetCompletedValue() mFenceValues[frame]) { mFence-SetEventOnCompletion(mFenceValues[frame], mFenceEvent); WaitForSingleObject(mFenceEvent, INFINITE); } mAllocators[frame]-Reset(); mCommandList-Reset(mAllocators[frame].Get(), mPipelineState.Get()); auto barrier CD3DX12_RESOURCE_BARRIER::Transition( mRenderTargets[frame].Get(), D3D12_RESOURCE_STATE_PRESENT, D3D12_RESOURCE_STATE_RENDER_TARGET); mCommandList-ResourceBarrier(1, barrier); const float clearColor[] { 0.05f, 0.05f, 0.08f, 1.0f }; auto rtv mRtvHeap-GetCPUDescriptorHandleForHeapStart(); rtv.ptr frame * mRtvDescriptorSize; mCommandList-OMSetRenderTargets(1, rtv, FALSE, nullptr); mCommandList-ClearRenderTargetView(rtv, clearColor, 0, nullptr); mCommandList-SetGraphicsRootSignature(mRootSignature.Get()); mCommandList-SetPipelineState(mPipelineState.Get()); mCommandList-IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_TRIANGLELIST); mCommandList-IASetVertexBuffers(0, 1, mVertexBufferView); mCommandList-DrawInstanced(3, 1, 0, 0); auto back CD3DX12_RESOURCE_BARRIER::Transition( mRenderTargets[frame].Get(), D3D12_RESOURCE_STATE_RENDER_TARGET, D3D12_RESOURCE_STATE_PRESENT); mCommandList-ResourceBarrier(1, back); mCommandList-Close(); ID3D12CommandList* lists[] { mCommandList.Get() }; mCommandQueue-ExecuteCommandLists(1, lists); mSwapChain-Present(1, 0); }我第一次跑通这段之后盯着那个纯色窗口看了很久因为在那之前我卡在了一个很蠢的地方RSSetViewports没调。D3D12里视口和裁剪矩形不会自动跟随窗口大小必须每帧或每次resize时显式设置CD3DX12_VIEWPORT viewport(0.0f, 0.0f, (float)mWidth, (float)mHeight); CD3DX12_RECT scissorRect(0, 0, (LONG)mWidth, (LONG)mHeight); mCommandList-RSSetViewports(1, viewport); mCommandList-RSSetScissorRects(1, scissorRect);不设的话行为是实现相关的有些驱动默认视口是全尺寸有些是0表现出来就是代码明明一样换台机器就不显示。4. 贴图实战从WIC解码到SRV采样4.1 纹理资源和缓冲资源的三个本质区别给三角形贴上图之前先理解纹理资源和顶点缓冲在DX12里的三个关键差异否则你会在拷贝阶段被行对齐折磨很久。第一纹理有多级子资源subresource。一个带Mipmap的纹理有log2(尺寸)层外加可能的数组切片拷贝时必须逐层处理不能像缓冲那样一次性CopyBufferRegion。第二纹理有行间距row pitch要求。上传堆里的每一行数据必须按256字节对齐D3D12_TEXTURE_DATA_PITCH_ALIGNMENT这个常量就是它。第三纹理要经过复制队列。默认堆的纹理不能被CPU映射必须先把CPU端数据写进上传堆再用CopyTextureRegion搬到默认堆。行对齐这个问题我单独讲一下因为它最容易出错。假设你要上传一张1920宽的RGBA贴图每像素4字节一行就是7680字节。7680除以256正好是30刚好对齐。但如果你上传一张640宽的图一行是2560字节2560除以256是10也对齐。真正出问题的是像333这种宽度一行1332字节需要向上取到1536字节中间多出来的204字节是填充。如果你按1332去填数据GPU读出来的画面就是斜的。4.2 用GetCopyableFootprints算清楚每一层不要去手算行间距用ID3D12Device::GetCopyableFootprintsstd::vectorD3D12_PLACED_SUBRESOURCE_FOOTPRINT layouts(mipLevels); std::vectorUINT numRows(mipLevels); std::vectorUINT64 rowSizes(mipLevels); UINT64 totalBytes 0; device-GetCopyableFootprints( textureDesc, 0, mipLevels, 0, layouts.data(), numRows.data(), rowSizes.data(), totalBytes);拿到layouts之后你按照每个Footprint.RowPitch去逐行拷贝解码结果而不是按原始宽度BYTE* destSlicePtr uploadPtr layouts[mip].Offset; BYTE* destRowPtr destSlicePtr; const BYTE* srcRowPtr decodedPixels (UINT64)row * srcRowPitch; for (UINT row 0; row numRows[mip]; row) { memcpy(destRowPtr, srcRowPtr, rowSizes[mip]); destRowPtr layouts[mip].Footprint.RowPitch; srcRowPtr srcRowPitch; }这段代码我抄错过两次第一次是忘了给srcRowPtr按解码图像的原始行距递增第二次是把rowSizes[mip]写成了整张图的字节数。两次的结果都是画面撕裂成条纹状。4.3 解码贴图WIC路径与格式转换的坑Windows自带的WICWindows Imaging Component能解码PNG、JPEG、BMP不需要引入第三方库这是我推荐的入门方案ComPtrIWICImagingFactory wicFactory; CoCreateInstance(CLSID_WICImagingFactory, nullptr, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(wicFactory)); ComPtrIWICBitmapDecoder decoder; wicFactory-CreateDecoderFromFilename(path, nullptr, GENERIC_READ, WICDecodeMetadataCacheOnDemand, decoder); ComPtrIWICBitmapFrameDecode frame; decoder-GetFrame(0, frame); ComPtrIWICFormatConverter converter; wicFactory-CreateFormatConverter(converter); converter-Initialize(frame.Get(), GUID_WICPixelFormat32bppRGBA, WICBitmapDitherTypeNone, nullptr, 0.0, WICBitmapPaletteTypeCustom);关键在最后那句格式转换。WIC解码出来的格式取决于源文件PNG可能是32bppBGRAJPEG可能是24bppBGR如果你不做转换直接按RGBA去解读红蓝通道会互换画面变成诡异的蓝脸。而且通道数是两回事24bpp意味着每像素3字节你按4字节的RowPitch去算数据会完全错位。还有一个细节GUID_WICPixelFormat32bppRGBA和GUID_WICPixelFormat32bppBGRA在DXGI里对应的格式是不同的前者对应DXGI_FORMAT_R8G8B8A8_UNORM后者对应DXGI_FORMAT_B8G8R8A8_UNORM。我用统一转RGBA的方式让整个工程只有一种纹理格式省掉很多分支判断。4.4 资源状态转换贴图加载里最容易漏的三步贴图的加载流程里有三次资源状态转换少任何一次都会出问题默认堆纹理创建时是D3D12_RESOURCE_STATE_COPY_DESTCopyTextureRegion执行完之后执行一次资源屏障切到D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE上传堆在拷贝完成后可以立刻Unmap但要注意映射的生命周期第2步的屏障必须和拷贝在同一个命令列表里且在拷贝之后、绘制之前mCommandList-CopyTextureRegion( CD3DX12_TEXTURE_COPY_LOCATION(mTexture.Get(), mip), CD3DX12_TEXTURE_COPY_LOCATION(mUploadBuffer.Get(), layouts[mip]), nullptr, nullptr); auto barrier CD3DX12_RESOURCE_BARRIER::Transition( mTexture.Get(), D3D12_RESOURCE_STATE_COPY_DEST, D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE); mCommandList-ResourceBarrier(1, barrier); mCommandList-Close(); mCommandQueue-ExecuteCommandLists(1, lists); mCommandQueue-Signal(mFence.Get(), mFenceValue); mFence-SetEventOnCompletion(mFenceValue, mFenceEvent); WaitForSingleObject(mFenceEvent, INFINITE);加载完之后要把上传堆的资源释放掉。我见过有人把上传堆的纹理一直留着结果显存占用随场景数量线性增长最后GPU内存耗尽。4.5 描述符堆、SRV与采样器采样链路的最后一公里到这里资源在显存里躺好了但着色器还不认识它。你需要三样东西一个SRV描述符、一个采样器、以及把它们和着色器变量名对应起来的绑定关系。SRV写在CBV_SRV_UAV类型的堆里并且这个堆必须ShaderVisible TRUED3D12_DESCRIPTOR_HEAP_DESC heapDesc{}; heapDesc.Type D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV; heapDesc.NumDescriptors 1; heapDesc.Flags D3D12_DESCRIPTOR_HEAP_FLAG_SHADER_VISIBLE; device-CreateDescriptorHeap(heapDesc, IID_PPV_ARGS(mSrvHeap)); D3D12_SHADER_RESOURCE_VIEW_DESC srvDesc{}; srvDesc.Shader4ComponentMapping D3D12_DEFAULT_SHADER_4_COMPONENT_MAPPING; srvDesc.Format textureDesc.Format; srvDesc.ViewDimension D3D12_SRV_DIMENSION_TEXTURE2D; srvDesc.Texture2D.MipLevels textureDesc.MipLevels; device-CreateShaderResourceView(mTexture.Get(), srvDesc, mSrvHeap-GetCPUDescriptorHandleForHeapStart());Shader4ComponentMapping这一项容易被忽略。默认的D3D12_DEFAULT_SHADER_4_COMPONENT_MAPPING等价于D3D12_ENCODE_SHADER_4_COMPONENT_MAPPING(0,1,2,3)也就是RGBA原样输出。如果你有单通道的遮罩贴图可以映射成只取R通道省带宽。入门阶段用默认值就行但知道这个字段存在以后做通道打包贴图时会省很多事。采样器我建议用静态采样器写在根签名里理由前面讲过。绑定阶段ID3D12DescriptorHeap* heaps[] { mSrvHeap.Get() }; mCommandList-SetDescriptorHeaps(1, heaps); mCommandList-SetGraphicsRootDescriptorTable(1, mSrvHeap-GetGPUDescriptorHandleForHeapStart());对应的着色器就是几行Texture2D gTexture : register(t0); SamplerState gSampler : register(s0); float4 PSMain(VSOutput input) : SV_TARGET { return gTexture.Sample(gSampler, input.uv); }顶点结构体里加一个float2 uv输入布局里加一项TEXCOORD语义然后给三个顶点分别赋(0.5, 0.0)、(1.0, 1.0)、(0.0, 1.0)三角形上就会出现半张图。这一步跑通的那一瞬间比画出纯色三角形爽得多。5. 真实调试记录这些坑我一个个趟过来的5.1 调试层报错速查表下面这张表是我这25集里真实遇到过、并且能给出确定解法的报错集合。它的价值在于很多报错的字面意思和真正的原因差得很远。调试层报错关键字真实原因处理方式Resource barrier required before use资源状态和当前用途不符在首次使用前加Transition屏障检查是否漏了COPY_DEST到SRV的那一步Descriptor heap is not shader visible采样用的堆用了非可见标志CBV_SRV_UAV堆必须加SHADER_VISIBLERTV堆则不需要Command allocator is still in use分配器在GPU执行完之前被Reset用围栏等待该帧的fence值确认已完成再ResetThe command list is not closed命令列表未Close就提交检查所有提前return的分支确保Close一定被调用Root signature does not match根签名和PSO或着色器绑定不符检查PSO占位符、根参数索引和register编号是否一一对应Invalid Swap Effect用了BITBLT模型的交换效果FLIP系列交换链必须用DXGI_SWAP_EFFECT_FLIP_DISCARD这张表里最坑的是第一条。它有时代码逻辑完全正确报错却来自资源创建时的初始状态和第一次屏障的目标状态不一致而这类不一致通常发生在我复制粘贴别的工程的初始化代码时。5.2 三角形不显示的四步定位法屏幕全黑但没有报错是DX12新手最常见的困境。我的排查顺序是固定的四步第一步确认清屏颜色生效。把ClearRenderTargetView的颜色改成刺眼的品红如果窗口还是黑的说明问题出在交换链或RTV绑定上和绘制无关。这一步能砍掉一半的可能性。第二步确认视口和裁剪矩形。前面说过D3D12不会自动设置我遇到过一次resize之后画面突然消失最后发现是视口还停留在旧尺寸上。第三步用PIX抓一帧看DrawCall有没有发生。如果PIX里能看到DrawInstanced并且顶点数正确说明问题在着色器输出或者光栅化状态如果看不到说明绘制根本没被录制进命令列表。这一步是我用PIX最频繁的场景。第四步检查顶点数据和坐标范围。顶点坐标是否在NDC范围内-1到1是不是不小心写了世界坐标。再检查FrontCounterClockwise和CullMode调试期先把CullMode设成NONE排除剔除问题确认能显示之后再调回来。这四步我跑下来通常十分钟内能定位而在没有这套方法论之前我靠的是漫无目的地改参数。5.3 GPU挂起与设备移除的排查思路设备移除Device Removed的报错信息特别不友好就一句DXGI_ERROR_DEVICE_REMOVED。但如果你开了DRED能拿到的信息量完全不同HRESULT reason device-GetDeviceRemovedReason(); ComPtrID3D12DeviceRemovedExtendedData dred; if (SUCCEEDED(device-QueryInterface(IID_PPV_ARGS(dred)))) { D3D12_DRED_AUTO_BREADCRUMBS_OUTPUT breadcrumbs{}; dred-GetAutoBreadcrumbsOutput(breadcrumbs); D3D12_DRED_PAGE_FAULT_OUTPUT faults{}; dred-GetPageFaultOutput(faults); // 遍历 breadcrumbs.pHeadAutoBreadcrumbNode 看最后完成的那个节点 }面包屑会告诉你最后一个成功执行的命令是哪个页错误输出会给你一个GPU访问失败的虚拟地址。我遇到过的典型情况有三种顶点缓冲地址为空导致读零页纹理拷贝时RowPitch传错导致越界以及索引缓冲越界。这三种都能通过页错误地址和资源创建顺序对照出来。另一种设备移除是超时也就是GPU真的在跑一个超长的绘制或者死循环。这类问题的特征是发生时间不固定通常和场景复杂度相关。控制面板里可以把TDR超时时间调长用于测试但这只是诊断手段不能当成最终方案。5.4 跨机器适配把能力检测做在前面程序在自己机器上跑得好好的换台机器就崩这是图形程序最常见的交付问题。我总结的适配检查清单有四项第一项是适配器和特性级检测。除了前面讲的D3D12CreateDevice探测还可以用CheckFeatureSupport查询具体能力比如D3D12_FEATURE_D3D12_OPTIONS里的资源绑定层级、D3D12_FEATURE_FEATURE_LEVELS里的最高特性级。第二项是描述符堆容量规划。不同厂商的驱动对NumDescriptors的上限不同有些只保证100万个有些更少。如果你的设计是每个物体一个CBV每个纹理一个SRV在大场景里很容易撞上限。我的做法是预留一块可增长的堆并且用CopyDescriptorsSimple做区间复制而不是每次新建。第三项是驱动版本与实际支持情况。玩家反馈中那种某某游戏报directx 12 is not supported on your system的情况开发者能做的就是把这个判断前置在启动时先做一次轻量探测给出可读的提示而不是等到初始化一半才崩。第四项是恢复与降级路径。交换链在设备移除后需要重建重建意味着RTV堆、渲染目标、缓冲全部重新创建。我建议从一开始就把资源创建抽成一个CreateDeviceDependentResources函数让重建路径和初始化路径复用同一份代码。这个设计我在第12集才想到前11集一直在手写两遍逻辑重复代码里藏了两个不一致的bug。6. 这套工程后续还能怎么长6.1 我踩过的三类效率陷阱第一个陷阱是过早抽象。我早期把每个D3D12对象都包一层类结果调一个Draw要跨四层封装调试器里根本看不出资源状态是在哪一层被改的。后来我改成接口薄、生命周期显式只有真正被复用的部分比如资源上传工具函数、围栏等待器才封装。第二个陷阱是忽略一帧的时间预算。DX12给了你控制力也给了你把CPU跑飞的能力。我做过一次测试每帧创建新的命令分配器而不是复用帧率直接掉到原来的三分之一。正确的做法是预创建固定数量的分配器和资源按帧轮转。第三个陷阱是不开校验就调性能。开着GBV测性能得到的数字毫无参考价值。我现在的习惯是做两个构建配置一个Debug带完整验证用于排查一个Release不带验证用于性能测量两边的资源管理逻辑完全一致。6.2 从贴图三角形往上走的几个方向贴图三角形跑通之后往下走的路比入门阶段清晰得多。我的建议顺序是先加深度缓冲和立方体因为这会逼你理解深度资源的状态转换和DSV堆这两块和之前学的RTV堆结构是镜像关系然后加常量缓冲和视图投影矩阵让物体真的动起来这一步会引入根参数的更新时机问题再往后是实例化和间接绘制这两个是DX12真正拉开与DX11差距的地方最后再做后处理和多重采样。有一条经验我特别想留给刚开始的人每加一个新特性都先把调试层开着跑一遍。DX12的调试信息质量很高只要你给它机会说话它几乎能指出每一处错误的位置。我前期的痛苦基本都来自嫌调试层扰乱输出窗口所以关掉了等重新开启之后之前花几天找不到的问题几分钟就定位了。这套25集的代码我后来整理成了一份可运行的起点工程每次开新项目都从它开始改比从头写模板省下的时间加起来大概有两三个工作日。