CreateIconIndirect像素数据规则疑问及实验异常现象咨询

问题核心原因 #

你的代码存在两个关键错误，和你对API参数、文档适用场景的理解偏差直接相关：

1. ICONINFO的hbmMask参数要求为1位单色位图，而非32位彩色位图
   根据CreateIconIndirect的参数规范，hbmMask是按位解析的单色掩码：位值为1表示对应位置像素完全透明，位值为0表示显示颜色位图的对应像素。你传入32位DIB作为掩码时，系统会将其所有原始字节按顺序视为位流解析，完全不会按你预期的“每个像素对应一个掩码值”处理，这是所有异常现象的根本原因。
2. 你查阅的BITMAPINFOHEADER文档说明存在场景限制
   你看到的“32位像素第4字节未使用”的说明，仅适用于传统GDI无Alpha混合的绘制场景。当你向CreateIconIndirect传入32位颜色位图、且系统支持Alpha图标时（Windows XP及以上版本默认支持），系统会直接将第4字节识别为预乘Alpha通道，此时不需要额外提供掩码位图，hbmMask可直接设为NULL。

对应疑问解答 #

1. 为何(a)行和(b)行结果不一致？
   你修改颜色位图第4字节（CA）时，该值已经被系统识别为Alpha通道生效，并非你以为的“被忽略”；叠加掩码解析完全错误的问题，同时第一轮其他区域像素为白色，错误的掩码导致部分区域透出了背景的记事本窗口颜色（你观测到的d3 e9 fe就是默认窗口背景的淡蓝色混合值），最终两个测试用例输出不同。
2. 为何(c)行和(a)行结果不同？
   系统解析单色掩码是读取整个位图的完整字节流作为位序列，而非单独解析每个像素对应的掩码值。你修改其他像素的字节值时，相当于修改了掩码位流中其他位置的位值，会直接改变系统对第一个像素的掩码判断结果，因此输出发生变化。
3. 为何所有(d)行结果一致、掩码不生效？
   当32位颜色位图的Alpha通道值为0xff（完全不透明）时，系统会优先识别到这是带Alpha通道的图标，直接忽略你传入的错误掩码位图，仅使用颜色位图的RGB值输出，因此无论你如何修改掩码的字节值，都不会影响最终结果。

修正方案 #

推荐你直接使用32位Alpha通道的实现方式，代码更简单也不会出现掩码解析错误：

HDC hDC = ::CreateCompatibleDC(nullptr);

BITMAPINFO bmiColor = {};
bmiColor.bmiHeader.biSize = sizeof(bmiColor.bmiHeader);
bmiColor.bmiHeader.biWidth = 16;
bmiColor.bmiHeader.biHeight = -16;
bmiColor.bmiHeader.biPlanes = 1;
bmiColor.bmiHeader.biBitCount = 32;
BYTE *byColor = nullptr;
HBITMAP hbmColor = ::CreateDIBSection(hDC, &bmiColor, DIB_RGB_COLORS,
                                      reinterpret_cast<void**>(&byColor),
                                      nullptr, 0);
// 填充为半透明白色示例：BGRA格式，Alpha=0x80
BYTE bgraColor[] = { 0xff, 0xff, 0xff, 0x80 };
for(int i = 0; i < 16 * 16; i++)
    for(int j = 0; j < 4; j++)
        byColor[i * 4 + j] = bgraColor[j];
// 左上角设为纯红不透明
byColor[0] = 0x00; byColor[1] = 0x00; byColor[2] = 0xff; byColor[3] = 0xff;

ICONINFO ii = {};
ii.fIcon = TRUE;
ii.xHotspot = ii.yHotspot = 0;
ii.hbmMask = nullptr; // 不需要掩码，直接用Alpha通道
ii.hbmColor = hbmColor;
HICON hIcon = ::CreateIconIndirect(&ii);
::SendMessage(hwndDialog, WM_SETICON, ICON_SMALL, reinterpret_cast<LPARAM>(hIcon));

如果必须使用掩码，需要专门创建1位的单色位图作为hbmMask，每一位对应一个像素的透明状态。

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