Share via

Метод 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

См. также раздел

IDWriteFontFileStream