IDWriteFontFace::GetFiles-Methode (dwrite.h)

Ruft die Schriftartdateien ab, die eine Schriftart darstellen.

Syntax

HRESULT GetFiles(
  [in, out]       UINT32          *numberOfFiles,
  [out, optional] IDWriteFontFile **fontFiles
);

Parameter

[in, out] numberOfFiles

Typ: UINT32*

Wenn fontFilesNULL ist, empfängt die Anzahl der Dateien, die die Schriftart darstellen. Andernfalls sollte die Anzahl der angeforderten Schriftartdateien übergeben werden. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".

[out, optional] fontFiles

Typ: IDWriteFontFile**

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein vom Benutzer bereitgestelltes Array, das Zeiger auf Schriftartdateien speichert, die die Schriftart darstellen. Dieser Parameter kann NULL sein, wenn der Benutzer nur die Anzahl der Dateien möchte, die die Schriftart darstellen. Diese API erhöht die Verweisanzahl der Schriftartdateizeiger, die gemäß COM-Konventionen zurückgegeben werden, und der Client sollte sie nach Abschluss freigeben.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Die IDWriteFontFace::GetFiles-Methode sollte zweimal aufgerufen werden. Das erste Mal, wenn Sie GetFilesfontFiles aufrufen, sollte NULL sein. Wenn die Methode zurückgibt, empfängt numberOfFiles die Anzahl der Schriftartdateien, die die Schriftart darstellen.

Rufen Sie dann die -Methode ein zweites Mal auf, und übergeben Sie dabei den numberOfFiles-Wert , der beim ersten Aufruf ausgegeben wurde, und einen Puffer ungleich NULL der richtigen Größe, um die IDWriteFontFile-Zeiger zu speichern.

Anforderungen

Weitere Informationen

IDWriteFontFace