DirectX 11纹理无法更新摄像头帧数据问题求助

第一步：立即启用DirectX调试层 #

不开调试层等于闭着眼排错，必须先打开：
在创建设备时，将D3D11_CREATE_DEVICE_DEBUG加入创建标志，示例：

UINT createDeviceFlags = 0;
#ifdef _DEBUG
createDeviceFlags |= D3D11_CREATE_DEVICE_DEBUG;
#endif
HRESULT hr = D3D11CreateDevice(..., &createDeviceFlags, ...);

启用后，调试输出窗口会打印所有资源错误、绑定问题等关键信息，这是解决问题的核心前提。

常见问题与修复方案 #

1. 纹理创建参数错误 #

动态更新的纹理必须设置正确的使用标志和访问权限，否则CPU无法写入：

• 必须指定D3D11_USAGE_DYNAMIC（动态资源，允许CPU写入）
• 必须包含D3D11_CPU_ACCESS_WRITE（CPU写权限）
• 必须绑定为着色器资源D3D11_BIND_SHADER_RESOURCE

错误示例（无法动态更新）：

D3D11_TEXTURE2D_DESC desc = {};
desc.Usage = D3D11_USAGE_DEFAULT; // 错误：默认资源CPU不能写
desc.CPUAccessFlags = 0; // 错误：无CPU写权限

正确示例：

D3D11_TEXTURE2D_DESC desc = {};
desc.Width = camWidth;
desc.Height = camHeight;
desc.MipLevels = 1;
desc.ArraySize = 1;
desc.Format = DXGI_FORMAT_R8G8B8A8_UNORM; // 需与摄像头帧格式匹配
desc.SampleDesc.Count = 1;
desc.Usage = D3D11_USAGE_DYNAMIC;
desc.CPUAccessFlags = D3D11_CPU_ACCESS_WRITE;
desc.BindFlags = D3D11_BIND_SHADER_RESOURCE;

2. Map/Unmap 使用错误 #

• Map标志选择：动态纹理更新优先用D3D11_MAP_WRITE_DISCARD（丢弃旧数据，无需同步，效率最高），如果需要保留部分数据可用D3D11_MAP_WRITE_NO_OVERWRITE
• 行对齐问题：DirectX纹理的行步长（pMappedResource->RowPitch）可能大于摄像头帧的每行字节数（比如摄像头是width*3字节，纹理Pitch可能因对齐变成更大的值），必须逐行复制，不能直接memcpy整个缓冲区：

正确的Map/Unmap更新代码：

void UpdateCamTexture(ID3D11DeviceContext* pCtx, ID3D11Texture2D* pTex, const BYTE* pCamBuffer, UINT width, UINT height, UINT camRowBytes)
{
    D3D11_MAPPED_SUBRESOURCE mapped;
    HRESULT hr = pCtx->Map(pTex, 0, D3D11_MAP_WRITE_DISCARD, 0, &mapped);
    if (FAILED(hr)) return;

    // 逐行复制，避免Pitch对齐问题
    BYTE* pDest = (BYTE*)mapped.pData;
    for (UINT y = 0; y < height; y++)
    {
        memcpy(pDest, pCamBuffer + y * camRowBytes, camRowBytes);
        pDest += mapped.RowPitch;
    }

    pCtx->Unmap(pTex, 0);
}

3. 像素格式不匹配 #

摄像头输出的帧格式（比如RGB24、RGBA32、YUY2等）必须与纹理格式完全一致：

• 如果摄像头输出BGR24，纹理要对应DXGI_FORMAT_B8G8R8X8_UNORM（或转换为RGBA后用DXGI_FORMAT_R8G8B8A8_UNORM）
• 若格式不匹配，即使数据复制成功，Shader读取的也是错误的像素数据，表现为全黑或色彩错乱

4. Shader资源视图（SRV）问题 #

确保创建的ID3D11ShaderResourceView与纹理格式匹配，且正确绑定到着色器：

D3D11_SHADER_RESOURCE_VIEW_DESC srvDesc = {};
srvDesc.Format = desc.Format;
srvDesc.ViewDimension = D3D11_SRV_DIMENSION_TEXTURE2D;
srvDesc.Texture2D.MipLevels = 1;
HRESULT hr = pDevice->CreateShaderResourceView(pTex, &srvDesc, &pSRV);

更新纹理后，无需重新创建SRV，但要确保在渲染时正确绑定该SRV到对应的Shader槽位。

5. UpdateSubresource 使用注意事项 #

如果用UpdateSubresource，需注意资源状态：

• 若纹理当前绑定为像素着色器资源，需先过渡到复制目标状态：

D3D11_RESOURCE_BARRIER barrier = {};
barrier.Type = D3D11_RESOURCE_BARRIER_TYPE_TRANSITION;
barrier.Flags = D3D11_RESOURCE_BARRIER_FLAG_NONE;
barrier.Transition.pResource = pTex;
barrier.Transition.StateBefore = D3D11_RESOURCE_STATE_PIXEL_SHADER_RESOURCE;
barrier.Transition.StateAfter = D3D11_RESOURCE_STATE_COPY_DEST;
pCtx->ResourceBarrier(1, &barrier);

// 执行UpdateSubresource
pCtx->UpdateSubresource(pTex, 0, nullptr, pCamBuffer, camRowBytes, 0);

// 过渡回着色器资源状态
barrier.Transition.StateBefore = D3D11_RESOURCE_STATE_COPY_DEST;
barrier.Transition.StateAfter = D3D11_RESOURCE_STATE_PIXEL_SHADER_RESOURCE;
pCtx->ResourceBarrier(1, &barrier);

不过对于动态纹理，Map/Unmap仍然是更高效的选择。

内容的提问来源于stack exchange，提问作者Sam99