DirectX11通过Map拷贝CPU像素数据到GPU后输出屏幕黑屏问题排查
问题排查及修复方案
1. 最常见诱因:纹理行对齐(Row Pitch)不匹配
Direct3D 11 中动态纹理映射后返回的 D3D11_MAPPED_SUBRESOURCE::RowPitch 是显卡驱动对齐后的值,通常会大于你手动计算的 width * 4(比如驱动默认按256字节对齐行数据),直接逐索引拷贝整个数组会导致后续行数据错位,最终渲染异常。
修正后的像素拷贝逻辑如下:
Platform::Array<unsigned char>^ datapointer = GetPixelBytes(); static constexpr int BYTES_IN_RGBA_PIXEL = 4; int srcRowPitch = BYTES_IN_RGBA_PIXEL * width; D3D11_MAPPED_SUBRESOURCE ms; auto device_context = m_deviceResource->GetD3DDeviceContext(); // 建议增加Map返回值校验 HRESULT mapHr = device_context->Map(m_texture->GetTexture2d(), 0, D3D11_MAP_WRITE_DISCARD, 0, &ms); if (SUCCEEDED(mapHr)) { uint8_t* mappedData = reinterpret_cast<uint8_t*>(ms.pData); // 逐行拷贝,避免行对齐导致的错位 for (int y = 0; y < height; y++) { memcpy(mappedData + y * ms.RowPitch, datapointer->Data + y * srcRowPitch, srcRowPitch); } device_context->Unmap(m_texture->GetTexture2d(), 0); }
2. 其他需要排查的点
- 纹理格式校验:确认
dxgiFormat和你的源像素格式匹配,比如源数据是RGBA顺序就要对应DXGI_FORMAT_R8G8B8A8_UNORM,如果是BGRA顺序就要对应DXGI_FORMAT_B8G8R8A8_UNORM,格式不匹配会出现颜色错误甚至全黑。 - 着色器资源视图(SRV)创建校验:你仅创建了ID3D11Texture2D对象,还需要基于该纹理创建对应的
ID3D11ShaderResourceView,并绑定到像素着色器的对应插槽,否则着色器无法采样到纹理数据。 - 纹理生命周期校验:确认
m_texture在渲染时已经完成数据加载,没有被提前释放或者未初始化就参与渲染。
内容的提问来源于stack exchange,提问作者DevSharma
相关产品推荐
相关产品推荐

