FONTOBJ_cGetGlyphs-Funktion (winddi.h)

Artikel
03/04/2024

Die FONTOBJ_cGetGlyphs-Funktion ist ein Dienst für den Schriftarten-Consumer, der Glyphenhandles in Zeiger auf Glyphendaten übersetzt, die bis zum nächsten Aufruf von FONTOBJ_cGetGlyphs gültig sind.

Syntax

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

Parameter

pfo

Zeiger auf eine FONTOBJ-Struktur , die die zu übersetzenden Glyphenhandles enthält.

[in] iMode

Gibt an, ob Daten als Bitmaps oder als Gliederungsobjekte geschrieben werden. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
FO_GLYPHBITS	Die Daten bestehen aus GLYPHBITS-Strukturen , die die Bitmaps der Glyphen definieren.
FO_PATHOBJ	Die Daten bestehen aus PATHOBJ-Strukturen , die die Umrisse der Glyphen definieren. Um zu bestimmen, ob der Pfad gefüllt oder striche werden soll, sollte der Schriftarten-Consumer das flInfo-Element der IFIMETRICS-Struktur überprüfen. Wenn das FM_INFO_RETURNS_STROKES-Flag festgelegt ist, sollte der Pfad stricheiert werden. Andernfalls sollte der Pfad ausgefüllt werden.

cGlyph

Gibt die Anzahl der zu übersetzenden Glyphen an. Der einzige zulässige Wert ist 1 (der Code geht von 1 aus, unabhängig vom angegebenen Wert).

phg

Zeiger auf ein Array von cGlyphen-HGLYPH-Strukturen, die vom Treiber bereitgestellt werden.

ppvGlyph

Zeiger auf einen Speicherspeicherort, der die Adresse einer GLYPHDATA-Struktur empfängt. Das erste Element dieser Struktur ist eine GLYPHDEF-Union , die je nach Wert des iMode-Parameters einen Zeiger auf eine GLYPHBITS-Struktur oder eine PATHOBJ-Struktur enthält. Wenn der Wert von iMode FO_GLYPHBITS ist, enthält (ppvGlyph)-gdf die Adresse einer GLYPHBITS-Struktur>. Wenn der Wert von iMode FO_PATHOBJ ist, enthält (ppvGlyph)-gdf die Adresse einer PATHOBJ-Struktur>.

Rückgabewert

Der Rückgabewert ist die Anzahl der Zeiger, die an den Treiber übergeben werden, wenn die Funktion erfolgreich ist. Andernfalls ist er 0, und ein Fehlercode wird protokolliert.

Hinweise

Diese Funktion sollte verwendet werden, wenn der Treiber Schriftarten zwischenspeichert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys