IDWriteFactory::CreateFontFileReference 方法 (dwrite.h)

从本地字体文件创建字体文件引用对象。

语法

HRESULT CreateFontFileReference(
  [in]           WCHAR const     *filePath,
  [in, optional] FILETIME const  *lastWriteTime,
  [out]          IDWriteFontFile **fontFile
);

参数

[in] filePath

类型: const WCHAR*

包含字体文件的绝对文件路径的字符数组。 如果用户提供的 filePath 与磁盘上的有效文件不对应,则对构造对象执行的后续操作可能会失败。

[in, optional] lastWriteTime

类型: const FILETIME*

输入文件路径的上次修改时间。 如果省略 参数,函数将访问字体文件以获取其上次写入时间。 应指定此值以避免额外的磁盘访问。 如果用户提供的 lastWriteTime 与磁盘上的文件不匹配,则对构造对象执行的后续操作可能会失败。

[out] fontFile

类型: IDWriteFontFile**

此方法返回时,包含指向新创建的字体文件引用对象的指针的地址,如果失败,则为 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

要求
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dwrite.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteFactory