You need to enable JavaScript to run this app. DirectX11通过Map拷贝CPU像素数据到GPU后输出屏幕黑屏问题排查
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 03:12:03