idWriteFontFace::GetFiles 方法 (dwrite.h)
获取表示字体的字体文件。
语法
HRESULT GetFiles(
[in, out] UINT32 *numberOfFiles,
[out, optional] IDWriteFontFile **fontFiles
);
参数
[in, out] numberOfFiles
类型: UINT32*
如果 fontFiles 为 NULL,则 接收表示字体的文件数。 否则,应传递请求的字体文件数。 有关详细信息,请参阅下面的备注部分。
[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 |