idWriteFontFace::GetFiles 方法 (dwrite.h)

获取表示字体的字体文件。

语法

HRESULT GetFiles(
  [in, out]       UINT32          *numberOfFiles,
  [out, optional] IDWriteFontFile **fontFiles
);

参数

[in, out] numberOfFiles

类型: UINT32*

如果 fontFilesNULL,则 接收表示字体的文件数。 否则,应传递请求的字体文件数。 有关详细信息,请参阅下面的备注部分。

[out, optional] fontFiles

类型: IDWriteFontFile**

此方法返回时,包含指向用户提供的数组的指针,该数组存储指向表示字体的字体文件的指针。 如果用户只需要表示字体的文件数,此参数可以为 NULL 。 此 API 根据 COM 约定递增返回的字体文件指针的引用计数,客户端应在完成后释放它们。

返回值

类型: HRESULT

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

备注

应调用 IDWriteFontFace::GetFiles 方法两次。 首次调用 GetFilesfontFiles 时应为 NULL。 当方法返回时, numberOfFiles 接收表示字体的字体文件数。

然后,再次调用方法,传递输出第一次调用的 numberOfFiles 值,以及用于存储 IDWriteFontFile 指针的正确大小的非 null 缓冲区。

要求

   
最低受支持的客户端 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

请参阅

IDWriteFontFace