IDWriteFactory3：：CreateFontFaceReference (WCHARconst*，FILETIMEconst*，UINT32，DWRITE_FONT_SIMULATIONS，IDWriteFontFaceReference**) 方法 (dwrite_3.h)

创建对给定完整路径的字体的引用。

语法

HRESULT CreateFontFaceReference(
  WCHAR const              *filePath,
  FILETIME const           *lastWriteTime,
  UINT32                   faceIndex,
  DWRITE_FONT_SIMULATIONS  fontSimulations,
  IDWriteFontFaceReference **fontFaceReference
);

参数

filePath

类型：[in] WCHAR

绝对文件路径。 如果用户提供的 filePath 不对应于磁盘上的有效文件，则对构造对象的后续操作可能会失败。

lastWriteTime

类型：[in，可选] FILETIME

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

faceIndex

类型： UINT32

当字体文件包含字体面集合时，字体面的从零开始的索引。
如果字体文件包含一张人脸，此值应为零。

fontSimulations

类型： DWRITE_FONT_SIMULATIONS

用于算法放大和斜体化的字体人脸模拟标志。

fontFaceReference

类型：[out] IDWriteFontFaceReference**

包含新创建的字体人脸引用对象，如果失败，则包含 nullptr。

返回值

类型： HRESULT

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

要求

最低受支持的客户端	Windows 10 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
目标平台	Windows
标头	dwrite_3.h
Library	Dwrite.lib
DLL	Dwrite.dll

请参阅

IDWriteFactory3