DirectX12调试层仅输出INFO日志无交换链创建报错问题咨询

CreateSwapChain属于DXGI接口的API，不属于D3D12核心API范畴，你仅启用D3D12调试层只能捕获D3D12内部逻辑的日志，DXGI层面的报错不会被输出，这是你看不到交换链创建错误的最主要原因。

• 首先在启用D3D12调试层的同位置，新增DXGI调试层的启用代码，完整示例如下：

#if defined(DEBUG) || defined(_DEBUG)
// 原有D3D12调试层启用逻辑
Microsoft::WRL::ComPtr<ID3D12Debug> debugController;
ThrowIfFailed(D3D12GetDebugInterface(IID_PPV_ARGS(&debugController)));
debugController->EnableDebugLayer();

// 新增DXGI调试层启用逻辑
Microsoft::WRL::ComPtr<IDXGIInfoQueue> dxgiInfoQueue;
if (SUCCEEDED(DXGIGetDebugInterface1(0, IID_PPV_ARGS(&dxgiInfoQueue))))
{
    // 开启错误、警告级别的日志输出触发
    dxgiInfoQueue->SetBreakOnSeverity(DXGI_DEBUG_ALL, DXGI_INFO_QUEUE_MESSAGE_SEVERITY_ERROR, TRUE);
    dxgiInfoQueue->SetBreakOnSeverity(DXGI_DEBUG_ALL, DXGI_INFO_QUEUE_MESSAGE_SEVERITY_WARNING, TRUE);
}
#endif

• 打开dxcpl.exe，切换到DXGI配置选项卡，将调试层选项设置为Application Controlled，确保你添加到Scope列表的可执行文件可以触发DXGI调试输出。
• 检查项目调试配置的链接器配置，确认链接器 -> 输入 -> 附加依赖项已经添加dxgi.lib，否则DXGI调试接口调用会失败。
• 若仍未输出报错，可以在CreateSwapChain调用后插入以下代码，主动拉取DXGI信息队列的错误日志：

Microsoft::WRL::ComPtr<IDXGIInfoQueue> dxgiInfoQueue;
if (SUCCEEDED(DXGIGetDebugInterface1(0, IID_PPV_ARGS(&dxgiInfoQueue))))
{
    UINT64 msgCount = dxgiInfoQueue->GetNumStoredMessages(DXGI_DEBUG_ALL);
    for (UINT64 i = 0; i < msgCount; i++)
    {
        SIZE_T msgLen = 0;
        dxgiInfoQueue->GetMessage(DXGI_DEBUG_ALL, i, nullptr, &msgLen);
        DXGI_INFO_QUEUE_MESSAGE* msg = (DXGI_INFO_QUEUE_MESSAGE*)malloc(msgLen);
        dxgiInfoQueue->GetMessage(DXGI_DEBUG_ALL, i, msg, &msgLen);
        OutputDebugStringA(msg->pDescription);
        free(msg);
    }
    dxgiInfoQueue->ClearStoredMessages(DXGI_DEBUG_ALL);
}

如果暂时不想调整调试层配置，可以先检查以下高频错误点：

• 传入的HWND窗口句柄是否有效，是否已经完成窗口注册、创建全流程，未被提前销毁
• 交换链描述的BufferCount、Format参数是否和当前使用的显示适配器输出能力匹配
• 调用交换链创建接口时使用的DXGI工厂，是否和你创建D3D12设备的适配器属于同一实例
• 目标窗口是否处于最小化、无客户区等无效渲染状态，窗口样式是否包含禁止输出的特殊标记

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