idWriteFontFileStream::ReadFileFragment 方法 (dwrite.h)
从字体文件中读取片段。
语法
HRESULT ReadFileFragment(
[out] void const **fragmentStart,
UINT64 fileOffset,
UINT64 fragmentSize,
[out] void **fragmentContext
);
参数
[out] fragmentStart
类型: const void**
此方法返回时,包含指向字体文件片段开头的指针的地址。 此参数未经初始化即被传递。
fileOffset
类型: UINT64
片段距字体文件开头的偏移量(以字节为单位)。
fragmentSize
类型: UINT64
文件片段的大小(以字节为单位)。
[out] fragmentContext
类型: void**
此方法返回时,包含指向要传递给 ReleaseFileFragment 的客户端定义上下文的指针的指针的地址。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
备注
请注意,ReadFileFragment 实现必须检查请求的字体文件片段是否在文件边界内。 否则,应从 ReadFileFragment 返回错误。
DirectWrite可以同时从多个线程对同一对象调用 IDWriteFontFileStream 方法。 因此,依赖于内部可变状态的 ReadFileFragment 实现必须跨多个线程序列化对此类状态的访问。 例如,使用单独的 Seek 和 Read 操作读取文件片段的实现必须将包含 Seek 和 Read 调用的代码块置于锁或关键节下。
要求
最低受支持的客户端 | 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 |