Compartilhar via

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

  • Artigo

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

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteFontFileStream