Share via


IDWriteFactory::RegisterFontFileLoader-Methode (dwrite.h)

Registriert ein Schriftartdateiladeprogramm bei DirectWrite.

Syntax

HRESULT RegisterFontFileLoader(
  IDWriteFontFileLoader *fontFileLoader
);

Parameter

fontFileLoader

Typ: IDWriteFontFileLoader*

Zeiger auf ein IDWriteFontFileLoader-Objekt für einen bestimmten Dateiressourcentyp.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion registriert einen Schriftartdateiladeprogramm bei DirectWrite. Die Schnittstelle zum Laden von Schriftartdateien, die von einem Singleton-Objekt implementiert werden soll, verarbeitet das Laden von Schriftartdateiressourcen eines bestimmten Typs aus einem Schlüssel. Eine bestimmte instance kann nur einmal registriert werden. Bei erfolgreichen Versuchen wird ein Fehler zurückgegeben, der angibt, dass er bereits registriert wurde. Beachten Sie, dass sich Die Implementierungen des Schriftartdateiladeprogramms nicht bei DirectWrite in ihren Konstruktoren registrieren dürfen und die Registrierung in ihren Destruktoren nicht aufheben dürfen, da registrierungs- und dekrementierungsvorgänge jeweils die Objektverweisanzahl erhöhen und dekrementieren. Stattdessen sollte die Registrierung und Aufhebung der Registrierung bei DirectWrite von Schriftartdateiladeprogrammen außerhalb der Implementierung des Schriftartdateiladeprogramms durchgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dwrite.h
Bibliothek Dwrite.lib
DLL Dwrite.dll