Метод 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, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | dwrite.h |
| Библиотека | Dwrite.lib |
| DLL | Dwrite.dll |