简介：这是一份面向Windows平台音视频开发者的D3D视频渲染源码工程，聚焦YV12等YUV格式在GPU上的着色器渲染实现，适合具备一定Direct3D与Shader基础、需要解决视频显示与格式兼容问题的中高级开发者参考。压缩包共72个文件，约1.05MB，以h头文件与cpp实现为主，辅以dll、lib、vcproj工程文件及exe测试程序，涵盖D3DManager、RenderFactory、各类Display与ShaderCode模块，结构清晰便于按格式定位代码。资源可同时支持YV12、I420、NV12、YUY2、UYVY、RGB24、RGB32、RGB555、RGB565等多种像素格式，并实现半透明文本叠加，已在Windows XP SP2、DXSDK9.0c与9800GT环境下测试通过。目前已有966人学习下载，读者可从中获取完整的D3D渲染管线组织方式、像素着色器编写思路与多格式适配方案，对理解GPU视频渲染与工程化封装具有实际参考价值。
1. 基于D3D的YV12视频渲染：为什么你的播放器在4K下掉帧，而别人稳如磐石
如果你做过视频播放器、录屏工具或者远程桌面客户端，大概率绕不开一个经典问题：解码器吐出的是 YV12 格式的原始帧，而屏幕要的是 RGB，中间这层转换和上屏如果走 CPU，4K 分辨率下光颜色空间转换就能吃掉你一半的帧预算。基于 D3D 的 YV12 视频渲染，说的就是把这层转换和上屏全部交给 GPU，让 CPU 只负责解码和调度。它解决的不是“能不能播”的问题，而是“高分辨率、高帧率下能不能稳”的问题。适合谁？适合已经能把视频解出来、但卡在渲染效率上的开发者，也适合想理解 GPU 视频管线到底怎么串起来的人。下面我按自己踩过的路，从格式本质讲到可复现的 D3D11 实现，再到参数调优和翻车现场。
2. YV12 与 D3D 纹理：先搞清楚 GPU 到底认不认这个格式
2.1 YV12 的内存布局与常见误判
YV12 属于 YUV 4:2:0 平面格式，三个平面依次排列：Y 平面完整分辨率，U 和 V 各是宽高的一半。很多人第一次拿到 YV12 数据，看到data[0]、data[1]、data[2]三个指针，就以为可以直接塞给一张纹理。实际上 D3D 纹理有严格的格式枚举，DXGI_FORMAT_NV12是 NV12，不是 YV12；D3D11 里没有DXGI_FORMAT_YV12这个枚举。这意味着你不能直接创建一张 YV12 纹理然后指望驱动帮你采样。
常见做法是：把 Y、U、V 三个平面分别上传到三张 R8 纹理，或者把 U/V 交错成一张 R8G8 纹理，再在像素着色器里做 YUV 到 RGB 的矩阵变换。前者实现简单但采样次数多，后者少一次采样但需要 CPU 做一次交错拷贝。我一般会先看解码器输出是否支持 NV12，如果支持就优先 NV12，因为 D3D11 对 NV12 有原生支持，视频处理器可以直接吃。如果只有 YV12，那就走三平面方案，别硬凑。
这里有个容易翻车的点：YV12 的 U 和 V 顺序。YV12 是 Y、V、U 还是 Y、U、V？标准写法里 YV12 的排列是 Y 平面后跟 V 平面再跟 U 平面，而 I420 是 Y、U、V。很多解码器标着 YV12 实际输出 I420，你按 YV12 去读 V 平面就会拿到 U 的数据，颜色直接偏绿或偏紫。血泪经验：拿到数据先渲一帧纯色测试图，确认 U/V 没反。
2.2 D3D11 纹理创建的关键参数
创建三张 R8 纹理时，Usage用D3D11_USAGE_DEFAULT，BindFlags给D3D11_BIND_SHADER_RESOURCE，CPUAccessFlags给 0。如果你需要 CPU 更新数据，可以用D3D11_USAGE_DYNAMIC加D3D11_CPU_ACCESS_WRITE，但动态纹理在每次Map时可能触发同步等待，4K 下不建议。更好的做法是用一个 staging 纹理做中转，或者直接让解码器输出到共享纹理。
// 创建 Y 平面纹理，宽高为视频原始尺寸 D3D11_TEXTURE2D_DESC descY = {}; descY.Width = width; descY.Height = height; descY.MipLevels = 1; descY.ArraySize = 1; descY.Format = DXGI_FORMAT_R8_UNORM; descY.SampleDesc.Count = 1; descY.Usage = D3D11_USAGE_DEFAULT; descY.BindFlags = D3D11_BIND_SHADER_RESOURCE; descY.CPUAccessFlags = 0; descY.MiscFlags = 0; // U/V 平面宽高各减半，注意宽高要向上取整到偶数 D3D11_TEXTURE2D_DESC descUV = descY; descUV.Width = (width + 1) / 2; descUV.Height = (height + 1) / 2; ID3D11Texture2D* texY = nullptr; ID3D11Texture2D* texU = nullptr; ID3D11Texture2D* texV = nullptr; device->CreateTexture2D(&descY, nullptr, &texY); device->CreateTexture2D(&descUV, nullptr, &texU); device->CreateTexture2D(&descUV, nullptr, &texV);逻辑说明：Y 平面用原始宽高，U/V 用一半宽高，这是 4:2:0 的基本要求。参数上MipLevels必须为 1，视频渲染不需要 mipmap；SampleDesc.Count为 1，不开 MSAA。如果宽高是奇数，U/V 的宽高要向上取整，否则采样时边缘会错位。创建完纹理后，每帧用UpdateSubresource把解码数据拷进去，注意UpdateSubresource的DstSubresource填 0，pDstBox传 nullptr 表示整张纹理更新。
2.3 着色器里的 YUV 到 RGB 矩阵
三张纹理绑定到像素着色器后，采样得到 y、u、v 三个值，范围都是 0 到 1。但视频的 YUV 通常是有限范围（16-235），而纹理采样出来是 0-1 的浮点，需要先做范围映射再做矩阵变换。常见做法是在着色器里写死 BT.601 或 BT.709 的系数，根据视频元数据切换。
// 像素着色器片段：BT.709 有限范围 YUV 转 RGB Texture2D texY : register(t0); Texture2D texU : register(t1); Texture2D texV : register(t2); SamplerState sampLinear : register(s0); float4 main(float2 uv : TEXCOORD0) : SV_Target { float y = texY.Sample(sampLinear, uv).r; float u = texU.Sample(sampLinear, uv).r; float v = texV.Sample(sampLinear, uv).r; // 有限范围映射到 0-1 y = (y - 16.0 / 255.0) * (255.0 / 219.0); u = (u - 128.0 / 255.0) * (255.0 / 224.0); v = (v - 128.0 / 255.0) * (255.0 / 224.0); // BT.709 矩阵 float r = y + 1.5748 * v; float g = y - 0.1873 * u - 0.4681 * v; float b = y + 1.8556 * u; return float4(saturate(float3(r, g, b)), 1.0); }参数说明：16.0/255.0和128.0/255.0是有限范围的偏移，255.0/219.0和255.0/224.0是缩放系数。BT.709 的系数和 BT.601 不同，用错会导致肤色偏黄或偏蓝。如果视频是全范围（0-255），偏移和缩放都要去掉。采样器用线性过滤，因为 U/V 是半分辨率，线性采样能减少色度块效应。注意saturate防止矩阵变换后溢出。
3. 用 D3D11 把 YV12 上屏：从纹理上传到交换链呈现
3.1 最小可跑通的渲染循环
一个完整的 D3D11 视频渲染循环包含：更新纹理、设置着色器资源、绘制全屏四边形、呈现。全屏四边形不需要顶点缓冲，用SV_VertexID在顶点着色器里生成即可，这样少一次 buffer 绑定。
// 每帧渲染流程 void RenderFrame(ID3D11DeviceContext* ctx, ID3D11Texture2D* texY, ID3D11Texture2D* texU, ID3D11Texture2D* texV, const uint8_t* yData, const uint8_t* uData, const uint8_t* vData, int width, int height) { // 上传 Y 平面 ctx->UpdateSubresource(texY, 0, nullptr, yData, width, 0); // 上传 U 平面，行 pitch 是 width/2 ctx->UpdateSubresource(texU, 0, nullptr, uData, (width + 1) / 2, 0); // 上传 V 平面 ctx->UpdateSubresource(texV, 0, nullptr, vData, (width + 1) / 2, 0); // 绑定着色器资源和采样器 ID3D11ShaderResourceView* srvs[3] = { srvY, srvU, srvV }; ctx->PSSetShaderResources(0, 3, srvs); ctx->PSSetSamplers(0, 1, &sampLinear); // 设置输入布局、着色器、绘制 ctx->IASetInputLayout(nullptr); ctx->IASetPrimitiveTopology(D3D11_PRIMITIVE_TOPOLOGY_TRIANGLESTRIP); ctx->VSSetShader(vsFullscreen, nullptr, 0); ctx->PSSetShader(psYUV, nullptr, 0); ctx->Draw(4, 0); // 呈现 swapChain->Present(1, 0); }逻辑说明：UpdateSubresource的第四个参数是源数据指针，第五个参数是行 pitch。Y 平面的 pitch 等于 width，U/V 的 pitch 等于(width+1)/2。如果解码器输出的数据有额外对齐（比如 pitch 是 64 的倍数），这里要填实际 pitch，不能直接用 width。Present的第一个参数是同步间隔，1 表示开启垂直同步，0 表示立即呈现。视频播放一般用 1 避免撕裂，但如果你要做低延迟，可以设 0 并配合DXGI_PRESENT_DO_NOT_WAIT。
3.2 交换链与全屏四边形的顶点着色器
交换链创建时，BufferCount至少 2，SwapEffect用DXGI_SWAP_EFFECT_FLIP_DISCARD，这样在 Windows 10 上能走独立翻转队列，性能更好。全屏四边形用SV_VertexID生成，顶点着色器输出裁剪空间坐标和纹理坐标。
// 顶点着色器：用 VertexID 生成全屏三角形带 struct VSOutput { float4 pos : SV_POSITION; float2 uv : TEXCOORD0; }; VSOutput main(uint vid : SV_VertexID) { VSOutput o; // 四个顶点：(-1,-1), (1,-1), (-1,1), (1,1) float2 pos = float2((vid & 1) * 2.0 - 1.0, (vid >> 1) * 2.0 - 1.0); o.pos = float4(pos, 0.0, 1.0); // 纹理坐标 Y 轴翻转，因为 D3D 纹理原点在左上 o.uv = float2(pos.x * 0.5 + 0.5, 0.5 - pos.y * 0.5); return o; }参数说明：vid & 1取最低位，vid >> 1取次低位，组合出四个顶点的位置。纹理坐标的 Y 轴翻转是因为 D3D 的纹理坐标原点在左上角，而裁剪空间 Y 轴向上，不翻转画面会上下颠倒。这个顶点着色器不需要顶点缓冲，Draw(4, 0)直接画三角形带。注意SV_VertexID从 0 开始，四个顶点顺序是左下、右下、左上、右上，三角形带会自动连成两个三角形。
3.3 多线程解码与渲染的同步
实际播放器里，解码和渲染通常不在同一个线程。解码线程把 YV12 数据放进队列，渲染线程从队列取数据上传纹理。这里的关键是纹理不能同时被读写，常见做法是双缓冲或三缓冲：渲染线程用一张纹理，解码线程写另一张，用围栏（fence）或事件同步。
// 用 D3D11 围栏做跨线程同步的简化示例 ID3D11Fence* fence = nullptr; device->CreateFence(0, D3D11_FENCE_FLAG_NONE, IID_PPV_ARGS(&fence)); UINT64 fenceValue = 0; // 渲染线程：上传完纹理后发出围栏信号 ctx->UpdateSubresource(texY, 0, nullptr, yData, width, 0); ctx->Signal(fence, ++fenceValue); // 解码线程：等待围栏后再写入下一帧数据 ctx->Wait(fence, fenceValue);逻辑说明：Signal在 GPU 命令队列里插入一个信号，Wait让 CPU 等待直到 GPU 完成到指定值。这样解码线程不会覆盖正在被 GPU 读取的纹理。如果不想用围栏，也可以用D3D11_QUERY_EVENT查询，但围栏更轻量。注意Wait会阻塞 CPU，如果解码线程和渲染线程是同一个线程，就不要用这套，直接顺序执行即可。
4. 避坑与排查：YV12 渲染翻车现场实录
4.1 画面偏绿或偏紫：U/V 平面顺序反了
现象：渲染出来的人脸发绿，或者整体偏紫。原因：YV12 和 I420 的 U/V 顺序不同，很多解码器标着 YV12 实际输出 I420。解决：交换 U 和 V 的纹理绑定顺序，或者在上传时交换uData和vData。最稳妥的办法是先用一张纯红测试图编码再解码，看渲染出来是不是红色。
4.2 4K 下掉帧严重：每帧都在创建纹理
现象：1080p 流畅，切到 4K 帧率直接腰斩。原因：在渲染循环里调用CreateTexture2D创建纹理，驱动每帧都在分配显存。解决：纹理在初始化时创建一次，尺寸变化时再重建。如果视频分辨率会动态切换，用纹理池复用，不要频繁创建销毁。
4.3 画面撕裂或抖动：Present 参数不对
现象：快速运动画面有横向撕裂，或者帧间隔不均匀。原因：Present的同步间隔设了 0，或者交换链BufferCount只有 1。解决：视频播放用Present(1, 0)开启垂直同步，BufferCount至少 2。如果要做低延迟，用DXGI_SWAP_CHAIN_FLAG_FRAME_LATENCY_WAITABLE_OBJECT配合WaitForSingleObject控制延迟。
4.4 颜色发灰：有限范围和全范围搞混
现象：画面像蒙了一层灰，黑色不黑，白色不白。原因：视频是有限范围（16-235），但着色器按全范围（0-255）处理，或者反过来。解决：根据视频元数据判断范围，在着色器里切换偏移和缩放系数。常见做法是传一个常量缓冲区，里面放rangeOffset和rangeScale，着色器里用y = (y - offset) * scale。
4.5 纹理上传带宽瓶颈：每帧全量上传
现象：GPU 占用不高但帧率上不去，CPU 占用也不高。原因：每帧用UpdateSubresource上传整张 4K 纹理，PCIe 带宽吃满。解决：如果解码器支持输出到共享纹理，直接让解码器写 GPU 纹理，跳过 CPU 拷贝。如果不支持，至少用Map/Unmap的D3D11_MAP_WRITE_DISCARD方式，让驱动做异步上传。
5. 进阶技巧：用视频处理器和硬件解码把 CPU 彻底解放
如果你已经跑通了三平面方案，下一步可以考虑 D3D11 的视频处理器（Video Processor）。它支持 NV12 输入，能直接做 YUV 到 RGB 的转换和缩放，而且是在 GPU 的固定功能单元里做，比像素着色器更省电。前提是解码器输出 NV12，或者你用视频处理器做 YV12 到 NV12 的转换。视频处理器的接口是ID3D11VideoDevice和ID3D11VideoContext，创建ID3D11VideoProcessorEnumerator和ID3D11VideoProcessor，然后调用VideoProcessorBlt。
// 创建视频处理器的关键步骤 D3D11_VIDEO_PROCESSOR_CONTENT_DESC contentDesc = {}; contentDesc.InputFrameFormat = D3D11_VIDEO_FRAME_FORMAT_PROGRESSIVE; contentDesc.InputWidth = width; contentDesc.InputHeight = height; contentDesc.OutputWidth = width; contentDesc.OutputHeight = height; contentDesc.Usage = D3D11_VIDEO_USAGE_PLAYBACK_NORMAL; ID3D11VideoProcessorEnumerator* enumerator = nullptr; videoDevice->CreateVideoProcessorEnumerator(&contentDesc, &enumerator); ID3D11VideoProcessor* processor = nullptr; videoDevice->CreateVideoProcessor(enumerator, 0, &processor); // 设置输入输出视图 D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC inputDesc = {}; inputDesc.FourCC = 0; inputDesc.ViewDimension = D3D11_VPIV_DIMENSION_TEXTURE2D; inputDesc.Texture2D.MipSlice = 0; inputDesc.Texture2D.ArraySlice = 0; ID3D11VideoProcessorInputView* inputView = nullptr; videoDevice->CreateVideoProcessorInputView(texNV12, enumerator, &inputDesc, &inputView); // 执行 Blt D3D11_VIDEO_PROCESSOR_STREAM stream = {}; stream.Enable = TRUE; stream.pInputSurface = inputView; videoContext->VideoProcessorBlt(processor, outputView, 0, 1, &stream);参数说明：InputFrameFormat填逐行扫描，Usage填播放模式。CreateVideoProcessorInputView的FourCC填 0 表示让驱动根据纹理格式推断。VideoProcessorBlt的最后一个参数是流数组，这里只传一路。视频处理器会自动处理颜色空间转换和缩放，你只需要把输出视图绑到交换链的后台缓冲上。注意视频处理器对 NV12 的支持最好，YV12 需要先转成 NV12，这个转换可以在 CPU 做，也可以用计算着色器做。
另一个进阶方向是硬件解码器直接输出到纹理。Intel、NVIDIA、AMD 都提供了解码器接口，能把解码后的 NV12 或 YV12 直接写进 D3D11 纹理，完全跳过 CPU 拷贝。这样 CPU 只负责调度，4K 60帧的 CPU 占用可以降到个位数。代价是代码复杂度上升，要处理不同厂商的接口差异和驱动兼容性。我一般会先做三平面方案保底，再逐步接入硬件解码和视频处理器，每步都留好回退路径。
最后说一个我自己的习惯：每次改渲染管线，先拿一张纯色图和一个灰阶渐变图做测试，确认颜色空间转换没问题，再上真实视频。这样出问题时能快速定位是格式错了还是矩阵错了。希望帮到你。
本文还有配套的精品资源，点击获取
