FONTOBJ_cGetGlyphs-Funktion (winddi.h)
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 |