IDWriteFactory::CreateFontFileReference-Methode (dwrite.h)

Erstellt ein Verweisobjekt für eine Schriftartdatei aus einer lokalen Schriftartdatei.

Syntax

HRESULT CreateFontFileReference(
  [in]           WCHAR const     *filePath,
  [in, optional] FILETIME const  *lastWriteTime,
  [out]          IDWriteFontFile **fontFile
);

Parameter

[in] filePath

Typ: const WCHAR*

Ein Array von Zeichen, das den absoluten Dateipfad für die Schriftartdatei enthält. Nachfolgende Vorgänge für das konstruierte Objekt können fehlschlagen, wenn der vom Benutzer bereitgestellte filePath nicht einer gültigen Datei auf dem Datenträger entspricht.

[in, optional] lastWriteTime

Typ: const FILETIME*

Der Zeitpunkt der letzten Änderung des Eingabedateipfads. Wenn der Parameter ausgelassen wird, greift die Funktion auf die Schriftartdatei zu, um die letzte Schreibzeit zu erhalten. Sie sollten diesen Wert angeben, um zusätzlichen Datenträgerzugriff zu vermeiden. Nachfolgende Vorgänge für das konstruierte Objekt können fehlschlagen, wenn der vom Benutzer bereitgestellte lastWriteTime nicht mit der Datei auf dem Datenträger übereinstimmt.

[out] fontFile

Typ: IDWriteFontFile**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das neu erstellte Verweisobjekt der Schriftartdatei oder NULL im Falle eines Fehlers.

Rückgabewert

Typ: HRESULT

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

Anforderungen

Weitere Informationen

IDWriteFactory