使用UpdateLayeredWindow渲染字体atlas文本失败（错误码87）求助

窗口与基础参数验证 #

• 确认窗口创建时已指定WS_EX_LAYERED扩展样式，无此样式调用UpdateLayeredWindow必然失败。
• 检查hwnd、hdcSrc、hdcDst等句柄是否有效：无效句柄（如NULL或已释放的DC）会直接触发错误87。若不需要源DC，直接传NULL即可。
• 核对dwFlags参数：只能是ULW_ALPHA、ULW_COLORKEY、ULW_OPAQUE三者之一，禁止传入无效组合或0。

位置与尺寸参数检查 #

• pptDst的坐标需落在屏幕可见范围内，且对应窗口的实际位置；psize若不为NULL，必须严格匹配待渲染区域的宽高（不能为0、负数或超出位图尺寸）。
• pptSrc指向的源位图起始坐标不能超出位图自身的宽高，比如位图宽100，传入x=150就会触发参数错误。

FreeType Atlas位图相关问题 #

• 必须使用32位ARGB格式的位图：UpdateLayeredWindow要求源位图带alpha通道（或指定颜色键），FreeType默认生成的灰度图需转换为ARGB格式（把灰度值作为alpha通道，或填充RGB通道）。
• 检查位图创建逻辑：用CreateDIBSection创建兼容位图时，确保BITMAPINFO结构体的biBitCount设为32，biCompression设为BI_RGB，避免格式不匹配。
• 验证位图数据完整性：FreeType生成的atlas数据写入位图内存时，确保没有越界写入，或指针传递错误（比如把8位数据指针传给32位位图的内存区域）。

代码逻辑细节核对 #

• 严格对照MSDN文档确认UpdateLayeredWindow的参数顺序：hwnd, hdcDst, pptDst, psize, hdcSrc, pptSrc, crKey, pblend, dwFlags，参数顺序错一位就会导致错误87。
• 调用UpdateLayeredWindow前先调用SetLastError(0)，调用后立即取错误码，避免之前的API错误干扰判断。
• 若使用BLENDFUNCTION结构体，确保SourceConstantAlpha和AlphaFormat设置正确：AlphaFormat需设为AC_SRC_ALPHA以启用通道alpha，否则会被视为无效参数。

快速定位问题的调试步骤 #

1. 替换测试：用一张已知可用的32位透明位图替换FreeType生成的atlas，调用UpdateLayeredWindow，如果成功，问题出在FreeType atlas的生成或转换环节。
2. 打印参数：把所有传入UpdateLayeredWindow的参数值（句柄数值、坐标、尺寸、flags、结构体成员）打印出来，逐一和预期值对比，很容易发现参数异常。
3. 简化代码：暂时移除FreeType相关逻辑，只保留最基础的分层窗口+UpdateLayeredWindow调用，确认基础流程正常后再逐步加回字体渲染逻辑。

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