Metodo IDWriteFontFileStream::ReadFileFragment (dwrite.h)

Legge un frammento da un file di tipo di carattere.

Sintassi

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

Parametri

[out] fragmentStart

Tipo: const void**

Quando termina, questo metodo contiene un indirizzo di un puntatore all'inizio del frammento di file di carattere. Questo parametro viene passato non inizializzato.

fileOffset

Tipo: UINT64

Offset del frammento, in byte, dall'inizio del file di carattere.

fragmentSize

Tipo: UINT64

Dimensioni del frammento di file, in byte.

[out] fragmentContext

Tipo: void**

Quando termina, questo metodo contiene l'indirizzo di un puntatore a un puntatore al contesto definito dal client da passare a ReleaseFileFragment.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Si noti che le implementazioni readFileFragment devono verificare se il frammento di file di carattere richiesto si trova all'interno dei limiti del file. In caso contrario, deve essere restituito un errore da ReadFileFragment.

DirectWrite possono richiamare i metodi IDWriteFontFileStream sullo stesso oggetto da più thread contemporaneamente. Di conseguenza, le implementazioni ReadFileFragment che si basano sullo stato modificabile interno devono serializzare l'accesso a tale stato tra più thread. Ad esempio, un'implementazione che usa operazioni Seek e Read separate per leggere un frammento di file deve inserire il blocco di codice contenente le chiamate Seek e Read in un blocco o in una sezione critica.

Requisiti

Vedi anche

IDWriteFontFileStream