使用IDXGIFactory2::CreateSwapChainForComposition方法时无法传递HDR元数据的技术咨询

我遇到过类似的问题，CreateSwapChainForComposition的HDR元数据传递逻辑确实和CreateSwapChainForHwnd有差异——虽然微软文档说全系列方法都应该转发元数据，但合成场景下有几个容易被忽略的前提条件，导致元数据看似设置成功却没生效。以下是排查和解决的关键点：

1. 交换链格式必须是HDR兼容格式 #

你当前使用的DXGI_FORMAT_B8G8R8A8_UNORM是SDR格式，DWM在合成这类交换链时会直接忽略HDR元数据。需要切换到HDR专用格式，推荐两种常用选项：

• DXGI_FORMAT_R10G10B10A2_UNORM：10-bit整数HDR格式，适配大多数消费级HDR显示设备
• DXGI_FORMAT_R16G16B16A16_FLOAT：浮点HDR格式，适合高精度动态范围场景

修改你的交换链描述代码：

DXGI_SWAP_CHAIN_DESC1 description = {};
description.Format = DXGI_FORMAT_R10G10B10A2_UNORM; // 替换为HDR兼容格式
description.BufferUsage = DXGI_USAGE_RENDER_TARGET_OUTPUT;
description.SwapEffect = DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL;
description.BufferCount = 2;
description.SampleDesc.Count = 1;
description.Flags = DXGI_SWAP_CHAIN_FLAG_ALLOW_TEARING;
// 其他尺寸参数保持不变...

同时，创建D3D设备时要验证硬件支持该格式作为渲染目标：

const D3D_FEATURE_LEVEL featureLevels[] = {
    D3D_FEATURE_LEVEL_11_1,
    D3D_FEATURE_LEVEL_11_0
};
UINT createDeviceFlags = D3D11_CREATE_DEVICE_BGRA_SUPPORT;
#ifdef _DEBUG
createDeviceFlags |= D3D11_CREATE_DEVICE_DEBUG;
#endif

HRESULT hr = D3D11CreateDevice(
    nullptr,
    D3D_DRIVER_TYPE_HARDWARE,
    nullptr,
    createDeviceFlags,
    featureLevels,
    ARRAYSIZE(featureLevels),
    D3D11_SDK_VERSION,
    &direct3dDevice,
    nullptr,
    nullptr
);
// 务必检查hr返回值，确保设备成功创建且支持目标HDR格式

2. 正确配置交换链的HDR相关参数 #

除了格式，还要确认两个关键配置：

• 若使用DXGI 1.4及以上版本，可给BufferUsage添加DXGI_USAGE_HDR_OUTPUT标记，明确告知DWM这是HDR内容（合成场景下虽非强制，但能减少兼容性问题）
• 避免使用可能绕过DWM合成的标志，比如DXGI_SWAP_CHAIN_FLAG_FULLSCREEN_VIDEO，这类标志会让交换链直接输出到硬件，跳过元数据转发逻辑

3. 确保HDR元数据结构填充有效 #

调用IDXGISwapChain4::SetHDRMetaData时，不能传递空或无效的元数据结构（比如全0值），DWM会忽略这类无效数据。示例填充逻辑：

DXGI_HDR_METADATA_TYPE1 hdrMetaData = {};
// 标准Rec.2020色域 primaries
hdrMetaData.RedPrimary[0] = 0.708f;
hdrMetaData.RedPrimary[1] = 0.292f;
hdrMetaData.GreenPrimary[0] = 0.170f;
hdrMetaData.GreenPrimary[1] = 0.797f;
hdrMetaData.BluePrimary[0] = 0.131f;
hdrMetaData.BluePrimary[1] = 0.046f;
hdrMetaData.WhitePoint[0] = 0.3127f;
hdrMetaData.WhitePoint[1] = 0.3290f;
// 内容亮度范围（根据你的实际内容调整）
hdrMetaData.MaxMasteringLuminance = 1000.0f;
hdrMetaData.MinMasteringLuminance = 0.01f;
hdrMetaData.MaxContentLightLevel = 800.0f;
hdrMetaData.MaxFrameAverageLightLevel = 200.0f;

m_swapChain->SetHDRMetaData(DXGI_HDR_METADATA_TYPE1, sizeof(hdrMetaData), &hdrMetaData);

4. 系统与合成环境的前提条件 #

• 确保Windows系统已开启HDR（路径：设置 > 系统 > 显示 > 使用HDR），未开启时DWM会自动转换为SDR输出，元数据直接被丢弃
• 确认你的DirectComposition链路完整：交换链必须关联到IDCompositionSurface，再添加到IDCompositionVisual并提交到合成器，链路断开会导致元数据无法传递到显示层

DirectX 12下的相同解决方案 #

DX12场景下的问题根源和解决逻辑完全一致：

• 交换链必须使用HDR兼容格式
• 创建DX12设备时验证格式支持
• 正确填充并设置HDR元数据
• 确保系统HDR开启且合成链路正常

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