【D3D11】ID3D11DeviceContext::UpdateSubresource 函数介绍

详细解释ID3D11DeviceContext::UpdateSubresource函数的用法。UpdateSubresource 函数详解函数原型voidUpdateSubresource(ID3D11Resource*pDstResource,// 目标资源纹理/缓冲区等UINT DstSubresource,// 目标子资源索引通常为 0constD3D11_BOX*pDstBox,// 目标区域NULL 表示整个资源constvoid*pSrcData,// 源数据指针UINT SrcRowPitch,// 源数据每行字节数UINT SrcDepthPitch// 源数据每深度字节数3D纹理用2D为0);参数详解参数类型说明pDstResourceID3D11Resource*要更新的目标资源可以是ID3D11Texture2D、ID3D11Buffer等DstSubresourceUINT子资源索引。对于普通 2D 纹理始终为0pDstBoxconst D3D11_BOX*定义目标资源中的更新区域。NULL表示更新整个资源pSrcDataconst void*指向源数据的内存指针SrcRowPitchUINT源数据中每一行的字节数 stride SrcDepthPitchUINT源数据中每个深度的字节数2D 纹理设为0D3D11_BOX 结构typedefstructD3D11_BOX{UINT left;// 左边界包含UINT top;// 上边界包含UINT front;// 前边界包含3D纹理用2D设为0UINT right;// 右边界不包含UINT bottom;// 下边界不包含UINT back;// 后边界不包含3D纹理用2D设为1}D3D11_BOX;重要right和bottom是不包含的即实际更新区域是宽度 right - left 高度 bottom - top 深度 back - front代码中的实际用法分析示例代码m_pImmediateContext-UpdateSubresource((ID3D11Resource*)pBackBuffer,// pDstResource: 后备缓冲区0,// DstSubresource: 第0层ptDstBox,// pDstBox: 目标区域窗口中的位置pRgbaData(tSrcRect.top*dwSrcWidthtSrcRect.left)*4,// pSrcData: 源数据起始地址dwSrcWidth*4,// SrcRowPitch: 源图像每行字节数0// SrcDepthPitch: 2D纹理为0);各参数解析参数值含义pDstResourcepBackBufferD3D 后备缓冲区最终显示的表面DstSubresource0后备缓冲区的第 0 层pDstBoxptDstBox目标矩形区域由调用者传入决定画在窗口的哪个位置pSrcDatapRgbaData offset从源图像的(tSrcRect.left, tSrcRect.top)位置开始SrcRowPitchdwSrcWidth * 4RGBA 格式每像素 4 字节所以每行 宽度 × 4SrcDepthPitch02D 图像无深度源数据地址计算pRgbaData(tSrcRect.top*dwSrcWidthtSrcRect.left)*4↑ ↑||跳过 top 行 跳过 left 列 总偏移量(行号 × 每行像素数列号)× 每像素字节数示例源图像尺寸1920×1080RGBAtSrcRect.left 100,tSrcRect.top 50偏移量 (50 × 1920 100) × 4 384,400 字节使用场景图示源图像 (pRgbaData) 目标后备缓冲区 (pBackBuffer) ┌─────────────────────┐ ┌─────────────────────┐ │ │ │ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │ │ tSrcRect │ │ ────────► │ │ ptDstBox │ │ │ │ (100,50) │ │ 复制数据 │ │ (x,y) │ │ │ │ 宽×高 │ │ │ │ 宽×高 │ │ │ └───────────┘ │ │ └───────────┘ │ │ │ │ │ └─────────────────────┘ └─────────────────────┘ dwSrcWidth × 4 后备缓冲区尺寸 (源行间距) (目标行间距由D3D管理)关键注意事项1.行对齐问题// 如果源数据有填充pitch 不等于宽度×4// 必须使用实际的 pitch 值不能简单用 width × 4// 错误如果有填充SrcRowPitchdwSrcWidth*4;// 正确SrcRowPitch实际的行字节数包含填充2.D3D11_BOX 的坐标系坐标是相对于目标资源的不是屏幕坐标right和bottom是不包含的边界// 示例更新目标区域的 (100, 100) 到 (300, 200)D3D11_BOX box;box.left100;box.top100;box.front0;box.right300;// 实际更新宽度 300 - 100 200box.bottom200;// 实际更新高度 200 - 100 100box.back1;3.与 Map/Unmap 的区别特性UpdateSubresourceMap/Unmap性能有额外拷贝开销直接访问 GPU 内存更快线程安全可在任意线程调用必须在创建资源的线程使用场景简单更新、小数据量频繁更新、大数据量资源要求任何资源需要D3D11_USAGE_DYNAMIC4.当前代码的潜在问题// 第 831-832 行m_pImmediateContext-UpdateSubresource((ID3D11Resource*)pBackBuffer,0,ptDstBox,pRgbaData(tSrcRect.top*dwSrcWidthtSrcRect.left)*4,dwSrcWidth*4,0);问题 1ptDstBox的坐标系ptDstBox定义的是后备缓冲区中的位置如果后备缓冲区和窗口尺寸不一致可能出现显示问题问题 2没有检查ptDstBox是否为 NULL如果ptDstBox为 NULL会更新整个后备缓冲区源数据尺寸必须匹配后备缓冲区尺寸问题 3SrcRowPitch计算假设源数据是紧密排列的无填充如果源数据有行填充会导致图像错位改进建议// 更安全的写法if(pBackBufferptDstBox){// 计算源数据起始地址BYTE*pSrcStartpRgbaData(tSrcRect.top*dwSrcWidthtSrcRect.left)*4;// 计算实际复制宽度和高度UINT copyWidthptDstBox-right-ptDstBox-left;UINT copyHeightptDstBox-bottom-ptDstBox-top;// 验证源数据范围if(tSrcRect.leftcopyWidthdwSrcWidthtSrcRect.topcopyHeightdwSrcHeight){m_pImmediateContext-UpdateSubresource(pBackBuffer,0,ptDstBox,pSrcStart,dwSrcWidth*4,// 源行间距0);}}总结UpdateSubresource是一个同步 CPU 到 GPU 的数据拷贝函数适合简单的纹理更新不需要频繁更新的场景不需要直接访问 GPU 内存的场景对于高性能视频渲染建议使用Map/Unmap或动态纹理当前代码中已实现m_bUseDynamicTexture路径。