PIX中DXIL着色器PDB自动解析失败问题（dxcompiler.dll编译）

我正按照微软PIX官方博客《在PIX中使用自动着色器PDB解析》的教程操作，博客中关于**为DXIL着色器生成PDB文件（基于dxcompiler.dll编译）**的说明如下：

你可以通过dxcompiler.dll暴露的工厂函数找到为DXIL着色器启用该功能的相关函数，步骤如下：

1. 使用以下标志编译着色器：
   • Zi：包含调试信息。
   • Zss 或 Zsb：为调试数据生成建议名称。其中Zss会同时对HLSL源代码和着色器二进制文件哈希来生成名称；Zsb则仅基于二进制文件哈希，不考虑源代码。
2. DXIL编译器提供了编译+提取调试信息的一站式机制：使用dxcapi.h中定义的IDxcCompiler3::Compile方法，通过IDxcResult接口可以获取调试数据的建议文件名指针，以及调试数据本身，只需将数据写入带有该建议名称的文件即可。

目前遇到的问题：
PIX输出显示它正在C:\Users\<user>\AppData\Local\Temp目录中查找PDB文件，该文件确实存在，但PIX无法自动加载。我怀疑是文件名设置错误？

我的DXIL文件中包含如下哈希值：

; shader hash: ac84a291f8e9974859fefeb01bd6f897

但这个哈希和IDxcResult::GetOutput(DXC_OUT_PDB, ...)返回的文件名中的哈希不一致，而IDxcResult::GetOutput(DXC_OUT_SHADER_HASH, ...)返回的哈希则和建议文件名中的哈希完全匹配。

我的编译代码如下：

winrt::com_ptr<IDxcBlobEncoding> pSource;
utils->LoadFile(hlsl.Path().c_str(), nullptr, pSource.put());
DxcBuffer buffer{ pSource->GetBufferPointer(), pSource->GetBufferSize(), DXC_CP_ACP };

LPCWSTR args[] = {
    L"-E", L"main",   // 入口点
    L"-T", L"cs_6_0",  // 目标着色器版本
    L"-Zi", L"-Zss",
};

winrt::com_ptr<IDxcResult> result;
winrt::check_hresult(
    compiler->Compile(
        &buffer,
        args, _countof(args),
        nullptr, IID_PPV_ARGS(&result)
    ));

HRESULT status = S_OK;
winrt::check_hresult(result->GetStatus(&status));

winrt::com_ptr<IDxcBlob> pDebugBlob;
winrt::com_ptr<IDxcBlobUtf16> pDebugName;
winrt::check_hresult(result->GetOutput(DXC_OUT_PDB, IID_PPV_ARGS(&pDebugBlob), pDebugName.put()));

wchar_t path[200U];
auto length = GetTempPathW(_countof(path), path);
_ASSERTE(pDebugName->GetStringLength() + length < 200U);
wcsncpy_s(path + length, 200U, (wchar_t*)pDebugName->GetBufferPointer(), pDebugName->GetStringLength());

std::ofstream ofs(path, std::ios::binary);
ofs.write((const char*)pDebugBlob->GetBufferPointer(), pDebugBlob->GetBufferSize());
ofs.close();

问题原因及解决方法 #

1. 哈希匹配逻辑差异
   PIX查找PDB时依赖的是DXIL文件中嵌入的shader hash，而当前用Zss编译时，生成的PDB文件名哈希是基于源代码+二进制的组合哈希，和DXIL里仅基于二进制的shader hash自然不一致，这就是PIX找不到对应PDB的核心原因。

2. 调整编译标志
   将编译参数中的Zss改为Zsb，这样生成的PDB文件名哈希会仅基于着色器二进制文件，和DXIL中嵌入的shader hash完全匹配。修改后的参数数组如下：

   LPCWSTR args[] = {
       L"-E", L"main",   // 入口点
       L"-T", L"cs_6_0",  // 目标着色器版本
       L"-Zi", L"-Zsb",
   };
   

3. 验证文件名匹配
   修改后重新编译，检查IDxcResult::GetOutput(DXC_OUT_SHADER_HASH, ...)返回的哈希是否和DXIL文件中的shader hash一致，同时确认生成的PDB文件名中的哈希和该值匹配。此时PIX应该能自动加载对应的PDB文件。

4. 额外检查项

   • 确保PDB文件确实被写入了PIX查找的Temp目录，且文件没有损坏。
   • 确认编译时没有其他额外参数干扰哈希生成，比如优化选项可能会改变二进制哈希，导致匹配失败。

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