如何用C++实现Windows显示器ICC配置文件自动切换适配HDR/SDR？

问题背景 #

Windows 11对HDR内容采用分段sRGB适配机制，会导致画面发灰、无法呈现纯黑。用户可通过加载匹配gamma 2.2的ICC配置文件解决，但需要在HDR/SDR模式切换时手动来回切换配置（SDR模式下需用默认配置，否则Gamma区间错误）。

我开发C++自动切换工具时，使用Windows ICM库的ColorProfileAddDisplayAssociation函数遇到瓶颈：该函数要求传入显示器的Source ID，但官方文档未明确其定义与Win32下的获取方式，仅在UWP Runtime中有相关提及。现有代码尝试将字符串转换为uint32作为Source ID，但完全无效。

核心疑问：

• Source ID在Win32环境下的准确定义是什么？
• 是否有官方文档遗漏的获取方法？
• 该自动切换功能是否可实现？

解决方案 #

Source ID的准确定义 #

Source ID是显示器的视频输出源标识符，对应DISPLAYCONFIG_SOURCE_DEVICE_NAME结构中的id字段，用于唯一标识显卡输出到特定显示器的视频源。

获取Source ID的正确方法 #

可通过Win32显示配置API枚举系统中的活跃显示源，匹配目标适配器LUID后提取对应的Source ID，示例代码如下：

#include <Windows.h>
#include <vector>

uint32_t GetActiveDisplaySourceID(LUID targetAdapterLUID) {
    uint32_t numPathArrayElements = 0;
    uint32_t numModeInfoArrayElements = 0;
    // 获取显示路径数组所需大小
    GetDisplayConfigBufferSizes(QDC_ONLY_ACTIVE_PATHS, &numPathArrayElements, &numModeInfoArrayElements);

    std::vector<DISPLAYCONFIG_PATH_INFO> pathArray(numPathArrayElements);
    std::vector<DISPLAYCONFIG_MODE_INFO> modeInfoArray(numModeInfoArrayElements);
    if (QueryDisplayConfig(QDC_ONLY_ACTIVE_PATHS, &numPathArrayElements, pathArray.data(), &numModeInfoArrayElements, modeInfoArray.data(), nullptr) != ERROR_SUCCESS) {
        return 0;
    }

    // 遍历活跃路径，匹配目标适配器LUID
    for (const auto& path : pathArray) {
        DISPLAYCONFIG_SOURCE_DEVICE_NAME sourceName;
        sourceName.header.type = DISPLAYCONFIG_DEVICE_INFO_GET_SOURCE_NAME;
        sourceName.header.size = sizeof(DISPLAYCONFIG_SOURCE_DEVICE_NAME);
        sourceName.header.adapterId = path.sourceInfo.adapterId;
        sourceName.header.id = path.sourceInfo.id;

        if (DisplayConfigGetDeviceInfo(&sourceName.header) == ERROR_SUCCESS) {
            if (sourceName.header.adapterId.LowPart == targetAdapterLUID.LowPart &&
                sourceName.header.adapterId.HighPart == targetAdapterLUID.HighPart) {
                return sourceName.header.id;
            }
        }
    }
    return 0;
}

修正后的调用代码 #

将原代码中Source ID的获取逻辑替换为上述函数：

LUID adapterLUID;
// 指定要关联的ICC配置文件
std::wstring profile = L"SDR ACM: srgb_d50 [ srgb_to_gamma2p2.cal ]";
PCWSTR pcwProfile = profile.c_str();

try {
    adapterLUID = getLUID();
} catch (const std::exception& ex) {
    return 1;
}

// 获取当前活跃显示器的Source ID
uint32_t sourceID = GetActiveDisplaySourceID(adapterLUID);
if (sourceID == 0) {
    // 处理Source ID获取失败的情况
    return 1;
}

HRESULT colorProfileResult = ColorProfileAddDisplayAssociation(
    WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE,
    pcwProfile,
    adapterLUID,
    sourceID,
    true,
    true
);

注意事项 #

1. 权限要求：修改系统级颜色配置关联需要管理员权限，需确保程序以管理员身份运行。
2. 多显示器适配：上述示例针对单显示器场景，多显示器需额外匹配显示器的设备名称或其他标识来定位目标Source ID。
3. ICC配置验证：确保传入的ICC配置名称与系统颜色管理中显示的完全一致，避免因名称不匹配导致关联失败。

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