Método IDWriteFontFileStream::ReadFileFragment (dwrite.h)

Lê um fragmento de um arquivo de fonte.

Sintaxe

HRESULT ReadFileFragment(
  [out] void const **fragmentStart,
        UINT64     fileOffset,
        UINT64     fragmentSize,
  [out] void       **fragmentContext
);

Parâmetros

[out] fragmentStart

Tipo: const void**

Quando esse método retorna, contém um endereço de um ponteiro para o início do fragmento do arquivo de fonte. Este parâmetro é passado não inicializado.

fileOffset

Tipo: UINT64

O deslocamento do fragmento, em bytes, desde o início do arquivo de fonte.

fragmentSize

Tipo: UINT64

O tamanho do fragmento de arquivo, em bytes.

[out] fragmentContext

Tipo: void**

Quando esse método retorna, contém o endereço de um ponteiro para um ponteiro para o contexto definido pelo cliente a ser passado para ReleaseFileFragment.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Observe que as implementações de ReadFileFragment devem marcar se o fragmento de arquivo de fonte solicitado está dentro dos limites do arquivo. Caso contrário, um erro deverá ser retornado de ReadFileFragment.

DirectWrite pode invocar métodos IDWriteFontFileStream no mesmo objeto de vários threads simultaneamente. Portanto, as implementações readFileFragment que dependem do estado mutável interno devem serializar o acesso a esse estado em vários threads. Por exemplo, uma implementação que usa operações separadas de Busca e Leitura para ler um fragmento de arquivo deve colocar o bloco de código que contém chamadas Seek e Read sob um bloqueio ou uma seção crítica.

Requisitos

Confira também

IDWriteFontFileStream