IDWriteFontFileStream::ReadFileFragment, méthode (dwrite.h)

Article
08/23/2023

Lit un fragment à partir d’un fichier de polices.

Syntaxe

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

Paramètres

[out] fragmentStart

Type : const void**

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers le début du fragment de fichier de police. Ce paramètre est passé sans être initialisé.

fileOffset

Type : UINT64

Décalage du fragment, en octets, par rapport au début du fichier de police.

fragmentSize

Type : UINT64

Taille du fragment de fichier, en octets.

[out] fragmentContext

Type : void**

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers un pointeur vers le contexte défini par le client à passer à ReleaseFileFragment.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Notez que les implémentations ReadFileFragment doivent case activée si le fragment de fichier de police demandé se trouve dans les limites du fichier. Sinon, une erreur doit être retournée à partir de ReadFileFragment.

DirectWrite pouvez appeler des méthodes IDWriteFontFileStream sur le même objet à partir de plusieurs threads simultanément. Par conséquent, les implémentations ReadFileFragment qui s’appuient sur un état mutable interne doivent sérialiser l’accès à cet état sur plusieurs threads. Par exemple, une implémentation qui utilise des opérations de recherche et de lecture distinctes pour lire un fragment de fichier doit placer le bloc de code contenant des appels De recherche et de lecture sous un verrou ou une section critique.

Spécifications


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteFontFileStream

Partager via