SetGraphicsRootConstantBufferView地址对齐错误的修复方案咨询

问题背景 #

触发错误：SetGraphicsRootConstantBufferView: Pointer 190513344 is incorrectly aligned，错误发生在RenderShadowMaps::Render方法的commandList->SetGraphicsRootConstantBufferView(2, lightGPUVirtualAdress);行，场景为单独访问灯光数组中的单个灯光以渲染阴影图。当前全局光照功能正常，但单灯光访问时触发对齐错误。

问题根源 #

D3D12硬性要求：通过SetGraphicsRootConstantBufferView绑定的常量缓冲区GPU虚拟地址，必须对齐到D3D12_CONSTANT_BUFFER_DATA_PLACEMENT_ALIGNMENT（默认值为256字节）。当前实现存在以下问题：

1. DX12Light结构体实际大小为188字节（加上16字节对齐后为200字节），远小于256字节的对齐要求
2. 计算单个灯光GPU地址时，使用i * sizeof(DX12Light)作为偏移，导致每个灯光的起始地址无法满足256字节对齐要求
3. 之前尝试填充结构体到256字节但未同步修改地址计算逻辑，导致灯光数据偏移错位，损坏光照循环

修复步骤 #

1. 同步CPU与HLSL侧的灯光结构体，确保单实例对齐到256字节 #

修改CPU侧DX12Light结构体，添加填充字段使其总大小为256字节，并保持16字节对齐：

__declspec(align(256)) struct DX12Light
{
    DirectX::XMFLOAT4 position;
    DirectX::XMFLOAT4 direction;
    DirectX::XMFLOAT4 color;

    DirectX::XMFLOAT4X4 transform1;
    DirectX::XMFLOAT4X4 transform2;

    FLOAT range;
    INT type;
    INT linearIdx;
    // 填充计算：256 - (16*3 + 64*2 + 4+4+4) = 256-188=68字节
    uint8_t padding[68];
};

同步修改HLSL侧的结构体定义：

struct DX12Light
{
    float4 position;
    float4 direction;
    float4 color;

    float4x4 transform1;
    float4x4 transform2;

    float range;
    int type;
    int linearIdx;
    // 68字节 = 17个uint（4字节/个）
    uint padding[17];
};

2. 修正单个灯光GPU地址计算逻辑 #

使用D3D12_CONSTANT_BUFFER_DATA_PLACEMENT_ALIGNMENT作为每个灯光的偏移步长，替代sizeof(DX12Light)：

std::vector<D3D12_GPU_VIRTUAL_ADDRESS> LightConstantBuffer::getMainLightGPUVirtualAddresses(const Scene::BaseScene& scene)
{
    const auto& lights = scene.getLights();
    _ASSERT(lights.size());

    std::vector<D3D12_GPU_VIRTUAL_ADDRESS> ret;
    ret.reserve(lights.size());

    const uint32_t lightAlignedStride = D3D12_CONSTANT_BUFFER_DATA_PLACEMENT_ALIGNMENT;
    for (uint32_t i = 0u; i < lights.size(); ++i)
    {
        ret.push_back(m_mainLightCBUploadHeap->GetGPUVirtualAddress() + i * lightAlignedStride);
    }

    return ret;
}

3. 修正灯光数据更新的内存拷贝偏移 #

在updateLight方法中，使用对齐后的步长计算内存拷贝的起始地址：

void LightConstantBuffer::updateLight(const Scene::BaseScene& scene, const EntityIdentifier& lightId, ID3D12GraphicsCommandList* commandList)
{
    const EntityIdentifierArray& lights = scene.getLights();
    const uint32_t lightAlignedStride = D3D12_CONSTANT_BUFFER_DATA_PLACEMENT_ALIGNMENT;

    int lightLinearIdx = 0;

    for (const auto& entityId : lights)
    {
        if (entityId == lightId)
        {
            updateLightEntry(scene, lightId, lightLinearIdx);
            memcpy(m_mainLightCBGPUAddress + lightLinearIdx * lightAlignedStride, &m_mainLightTransientBUffer.lights[lightLinearIdx], sizeof(DX12Light));
            break;
        }
        ++lightLinearIdx;
    }
}

4. 修正常量缓冲区的创建大小计算 #

确保缓冲区总大小满足D3D12的资源对齐要求：

// 自定义对齐宏，支持指定对齐边界
#define _ALIGN_SIZE(x, align) ((x) + (align - 1)) & ~(align - 1)

// 总大小 = 最大灯光数 × 256字节，再对齐到D3D12默认资源对齐边界
const nbUint32 MainLightCBAlignedSize = _ALIGN_SIZE(
    Graphics::Light::MaxLightsPerScene * D3D12_CONSTANT_BUFFER_DATA_PLACEMENT_ALIGNMENT,
    D3D12_DEFAULT_RESOURCE_PLACEMENT_ALIGNMENT
);

// 缓冲区创建代码保持不变，使用上面的MainLightCBAlignedSize
HRESULT hr = D3D12Device->CreateCommittedResource(
    &CD3DX12_HEAP_PROPERTIES(D3D12_HEAP_TYPE_UPLOAD),
    D3D12_HEAP_FLAG_NONE,
    &CD3DX12_RESOURCE_DESC::Buffer(MainLightCBAlignedSize),
    D3D12_RESOURCE_STATE_GENERIC_READ,
    nullptr,
    IID_PPV_ARGS(&m_mainLightCBUploadHeap)
);
_ASSERT(SUCCEEDED(hr));

验证方法 #

1. 编译运行程序，检查阴影图渲染时是否不再触发对齐错误
2. 验证全局光照与单灯光阴影渲染功能是否正常
3. 使用D3D12调试层检查是否存在其他对齐相关的警告或错误

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