IShellItemImageFactory::GetImage返回倒立HBITMAP且无负高度的问题

问题背景 #

已实现Shell枚举，可正常获取项目名称及关联图像（缩略图显示正常，图标显示倒立）。调用IShellItemImageFactory::GetImage获取图像时，返回的HBITMAP对应的DIBSECTION无负高度、负步幅等异常标识，但图标数据确实为倒立状态，GDI+可自动处理该问题，但需实现无GDI+依赖的判断逻辑。

调用代码：

imageFactory.GetImage(new(200, 200), SIIGBF.SIIGBF_BIGGERSIZEOK, out var bitmap);

核心原因 #

IShellItemImageFactory返回的图标类图像（区别于文件缩略图）常基于系统ICON资源生成，ICON的像素存储采用顶行优先（图像首行对应像素数据的起始位置），而标准DIB（设备无关位图）默认采用底行优先。Shell返回的HBITMAP通过兼容层包装后，GetObject获取的DIBSECTION未正确标记该方向差异，导致直接渲染时出现倒立。

无GDI+依赖的判断方法 #

方法1：利用GetDIBits检测真实存储方向 #

GetDIBits可直接解析位图的实际像素存储方向，即使DIBSECTION未标记，该函数也会返回正确的biHeight值（负数表示顶行优先，需翻转）。示例代码：

#include <windows.h>

bool IsBitmapTopDown(HBITMAP hBitmap) {
    BITMAP bmpInfo = {0};
    if (!GetObject(hBitmap, sizeof(BITMAP), &bmpInfo)) {
        return false;
    }

    BITMAPINFOHEADER bih = {0};
    bih.biSize = sizeof(BITMAPINFOHEADER);
    bih.biWidth = bmpInfo.bmWidth;
    bih.biHeight = 0; // 让系统自动填充方向信息
    bih.biPlanes = 1;
    bih.biBitCount = bmpInfo.bmBitsPixel;
    bih.biCompression = BI_RGB;

    // 无需获取实际像素，仅需获取正确的biHeight值
    HDC hDC = GetDC(NULL);
    int result = GetDIBits(hDC, hBitmap, 0, 0, NULL, (BITMAPINFO*)&bih, DIB_RGB_COLORS);
    ReleaseDC(NULL, hDC);

    return (result != 0 && bih.biHeight < 0);
}

调用该函数返回true时，说明图像为顶行优先，需翻转行顺序后渲染。

方法2：结合Shell请求上下文推断 #

如果你的场景中明确区分“缩略图”和“图标”请求：

• 当请求尺寸为系统图标标准尺寸（16x16、32x32、48x48、256x256等），或针对文件类型/系统项请求图标时，可预先标记需要翻转
• 针对文件内容缩略图（如图片、文档预览），则无需翻转

这种方法适合场景明确的情况，无需额外GDI调用，但通用性稍弱。

方法3：像素特征校验（极端 fallback） #

若前两种方法无法覆盖，可提取图像首行和末行的像素数据，对比预期的图标特征（如文件夹图标顶部为浅灰、底部为深灰），判断是否倒立。这种方法需针对特定图标类型做适配，仅作为最后手段。

翻转实现参考 #

确认需要翻转后，可通过手动调整像素数据的行顺序实现：

void FlipBitmapRows(BYTE* pPixelData, int width, int height, int bytesPerRow) {
    BYTE* pTempRow = new BYTE[bytesPerRow];
    for (int i = 0; i < height / 2; i++) {
        BYTE* pTopRow = pPixelData + i * bytesPerRow;
        BYTE* pBottomRow = pPixelData + (height - 1 - i) * bytesPerRow;
        memcpy(pTempRow, pTopRow, bytesPerRow);
        memcpy(pTopRow, pBottomRow, bytesPerRow);
        memcpy(pBottomRow, pTempRow, bytesPerRow);
    }
    delete[] pTempRow;
}

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