Compartir a través de

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

  • Artículo

Lee un fragmento de un archivo de fuente.

Sintaxis

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

Parámetros

[out] fragmentStart

Tipo: const void**

Cuando este método devuelve, contiene una dirección de un puntero al inicio del fragmento de archivo de fuente. Este parámetro se pasa sin inicializar.

fileOffset

Tipo: UINT64

Desplazamiento del fragmento, en bytes, desde el principio del archivo de fuente.

fragmentSize

Tipo: UINT64

Tamaño del fragmento de archivo, en bytes.

[out] fragmentContext

Tipo: void**

Cuando este método vuelve, contiene la dirección de un puntero a un puntero al contexto definido por el cliente que se va a pasar a ReleaseFileFragment.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Tenga en cuenta que las implementaciones de ReadFileFragment deben comprobar si el fragmento de archivo de fuente solicitado está dentro de los límites del archivo. De lo contrario, se debe devolver un error de ReadFileFragment.

DirectWrite pueden invocar métodos IDWriteFontFileStream en el mismo objeto desde varios subprocesos simultáneamente. Por lo tanto, las implementaciones de ReadFileFragment que se basan en el estado mutable interno deben serializar el acceso a dicho estado en varios subprocesos. Por ejemplo, una implementación que usa operaciones Seek y Read independientes para leer un fragmento de archivo debe colocar el bloque de código que contiene las llamadas Seek y Read bajo un bloqueo o una sección crítica.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dwrite.h
Library Dwrite.lib
Archivo DLL Dwrite.dll

Consulte también

IDWriteFontFileStream