Direct2D中CreateCustomFontFileReference调用失败，错误0x80070057

错误0x80070057（参数不正确）在调用CreateCustomFontFileReference时，通常是传入的参数不符合DWrite的要求，以下是常见排查方向和解决方法：

• 验证内存缓冲区与大小的匹配性
  确保传入的内存缓冲区指针非空，且fileSize参数严格等于字体文件的实际字节大小。很多时候问题出在这里：比如读取字体文件到内存时错误计算了文件大小（比如误用文件指针位置而非实际文件大小），或者缓冲区未分配足够空间。
  可添加基础验证逻辑：

  // 假设fontBuffer是内存缓冲区，fileSize是传入的大小参数
  if (!fontBuffer || fileSize == 0) {
      return E_INVALIDARG; // 缓冲区无效或大小异常
  }
  // 额外验证字体文件标识（TrueType/OpenType开头特征）
  uint32_t* fontMagic = reinterpret_cast<uint32_t*>(fontBuffer);
  if (*fontMagic != 0x4F54544F && *fontMagic != 0x00000100) {
      // 内存数据不是有效的TrueType/OpenType文件
  }
  

• 确认DWRITE_FONT_FILE_TYPE参数正确
  第三个参数fontFileType必须与字体文件实际类型匹配：

  • TrueType/普通OpenType字体传DWRITE_FONT_FILE_TYPE_TRUETYPE
  • OpenType CFF字体传DWRITE_FONT_FILE_TYPE_OPENTYPE_CFF
    避免错误传入DWRITE_FONT_FILE_TYPE_UNKNOWN，除非确实无法确定类型（但此情况可能导致识别失败）。

• 检查字体文件的完整性
  将内存缓冲区写入本地文件，用系统字体查看器打开验证是否能正常识别。如果文件损坏，即使参数格式正确也会触发错误。

• 验证IDWriteFactory实例有效性
  确保调用CreateCustomFontFileReference时使用的IDWriteFactory实例未被释放、处于正常状态。无效的工厂实例也可能导致参数错误返回。

• 检查参数类型匹配
  确保所有参数类型严格符合函数定义：

  • fontFileReferenceKey是void const*类型，避免传入错误的指针类型（比如非const指针强制转换异常）
  • fontFileReferenceKeySize是UINT32类型，不要传入超出范围的数值（比如64位整数截断为32位导致大小错误）

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