如何在Windows 10 Credential Provider中加载透明圆形磁贴图片

• 原有PNG加载逻辑使用Gdiplus::Bitmap::GetHBITMAP生成的是不带正确预乘Alpha通道的设备相关位图（DDB），Credential Provider的渲染层无法识别其透明信息，因此会显示黑/白纯色背景。
• BMP格式本身不携带Alpha通道，LoadBitmap API加载的位图默认忽略透明信息，无法实现圆角透明效果。
• Win10 Credential Provider对SFI_TILEIMAGE字段返回的位图有明确格式要求：必须是32位ARGB、预乘Alpha格式的设备无关位图（DIB段），否则透明通道不会生效。

1. 准备资源 #

• 导出32位带Alpha通道的PNG图片，圆形磁贴外区域像素Alpha值设为0，不要添加任何纯色背景。
• 按系统DPI缩放准备多尺寸资源避免模糊：100%缩放用96x96像素、125%用120x120、150%用144x144、200%用192x192。
• 将PNG以自定义资源类型PNG嵌入DLL，不要转换为BMP格式，rc文件中资源定义示例：

  IDP_TILE_IMAGE PNG "tile_96.png"
  

2. 修正GDI+初始化逻辑 #

GDI+只需要全局初始化一次，不要在每次加载图片时重复调用启动/关闭接口，避免资源泄漏和加载异常：

#include <windows.h>
#include <gdiplus.h>
#pragma comment(lib, "gdiplus.lib")

// 全局GDI+令牌
ULONG_PTR g_gdiToken = 0;

// DLL_PROCESS_ATTACH时调用
void InitGDI()
{
    Gdiplus::GdiplusStartupInput si;
    Gdiplus::GdiplusStartup(&g_gdiToken, &si, nullptr);
}

// DLL_PROCESS_DETACH时调用
void ShutdownGDI()
{
    if (g_gdiToken != 0)
    {
        Gdiplus::GdiplusShutdown(g_gdiToken);
        g_gdiToken = 0;
    }
}

3. 实现带Alpha通道的PNG加载函数 #

不要使用GetHBITMAP接口，手动创建32位预乘Alpha格式的DIB段，复制像素数据：

HBITMAP LoadAlphaPNG(HINSTANCE hInst, UINT resId)
{
    HBITMAP hResult = nullptr;
    HRSRC hRsrc = FindResource(hInst, MAKEINTRESOURCE(resId), L"PNG");
    if (!hRsrc) return nullptr;

    DWORD resSize = SizeofResource(hInst, hRsrc);
    HGLOBAL hResLoaded = LoadResource(hInst, hRsrc);
    if (!hResLoaded || resSize == 0) return nullptr;

    void* pResData = LockResource(hResLoaded);
    if (!pResData) return nullptr;

    HGLOBAL hMem = GlobalAlloc(GMEM_MOVEABLE, resSize);
    if (!hMem)
    {
        FreeResource(hResLoaded);
        return nullptr;
    }

    void* pMemData = GlobalLock(hMem);
    memcpy(pMemData, pResData, resSize);
    GlobalUnlock(hMem);

    IStream* pStream = nullptr;
    if (SUCCEEDED(CreateStreamOnHGlobal(hMem, TRUE, &pStream)) && pStream)
    {
        Gdiplus::Bitmap* pBmp = Gdiplus::Bitmap::FromStream(pStream);
        pStream->Release();

        if (pBmp && pBmp->GetLastStatus() == Gdiplus::Ok)
        {
            UINT bmpWidth = pBmp->GetWidth();
            UINT bmpHeight = pBmp->GetHeight();

            // 构建32位DIB段信息
            BITMAPINFO bmi = {0};
            bmi.bmiHeader.biSize = sizeof(BITMAPINFOHEADER);
            bmi.bmiHeader.biWidth = bmpWidth;
            bmi.bmiHeader.biHeight = -static_cast<LONG>(bmpHeight); // 负值创建顶-down位图，避免图像倒置
            bmi.bmiHeader.biPlanes = 1;
            bmi.bmiHeader.biBitCount = 32;
            bmi.bmiHeader.biCompression = BI_RGB;

            void* pBits = nullptr;
            hResult = CreateDIBSection(nullptr, &bmi, DIB_RGB_COLORS, &pBits, nullptr, 0);
            if (hResult && pBits)
            {
                Gdiplus::Rect lockRect(0, 0, bmpWidth, bmpHeight);
                Gdiplus::BitmapData bmpData;
                bmpData.Stride = bmpWidth * 4;
                bmpData.Scan0 = pBits;
                // 以预乘ARGB格式锁定位图数据，直接写入DIB段内存
                pBmp->LockBits(&lockRect, Gdiplus::ImageLockModeRead | Gdiplus::ImageLockModeUserInputBuf,
                    PixelFormat32bppPARGB, &bmpData);
                pBmp->UnlockBits(&bmpData);
            }
            delete pBmp;
        }
    }
    FreeResource(hResLoaded);
    return hResult;
}

4. 修改磁贴位图返回逻辑 #

直接返回加载得到的带Alpha通道的HBITMAP即可，Credential Provider框架会负责销毁该位图：

HRESULT GetBitmapValue(DWORD dwFieldID, HBITMAP* phbmp)
{
    if (dwFieldID != SFI_TILEIMAGE || !phbmp)
    {
        return E_INVALIDARG;
    }

    *phbmp = LoadAlphaPNG(HINST_THISDLL, IDP_TILE_IMAGE);
    return *phbmp ? S_OK : E_FAIL;
}

• 必须使用PixelFormat32bppPARGB（预乘Alpha）格式，普通非预乘ARGB格式会导致透明边缘出现黑边，和系统原生磁贴效果不一致。
• 不要使用LoadBitmap、LoadImage等常规位图加载接口加载磁贴，这类接口会自动忽略Alpha通道。
• 如果加载后仍显示方形背景，先检查PNG资源是否为32位带Alpha通道格式，部分图片导出时会错误地保存为24位无Alpha格式。
• 高DPI适配可通过GetDpiForWindow获取当前缩放比例，动态加载对应尺寸的PNG资源，避免磁贴模糊。

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