DrvGetGlyphMode-Funktion (winddi.h)

Artikel
03/13/2024

Die DrvGetGlyphMode-Funktion teilt GDI mit, wie Glypheninformationen zwischengespeichert werden.

Syntax

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

Parameter

[in] unnamedParam1

Verarbeiten der PDEV-Struktur eines physischen Geräts.

[in] unnamedParam2

Zeiger auf eine FONTOBJ-Struktur , die abgefragt werden kann, um den Schriftgrad, die Transformation und andere Schriftartattribute zu finden.

Rückgabewert

DrvGetGlyphMode gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
FO_GLYPHBITS	GDI sollte alle Glyphendaten für diese Schriftart zwischenspeichern.
FO_HGLYPHS	Das Gerät speichert Schriftarten selbst zwischen, sodass GDI nur Glyphenhandles für diese Schriftart zwischenspeichern sollte.
FO_PATHOBJ	GDI sollte PATHOBJ-Strukturen für diese Schriftart zwischenspeichern.

Hinweise

GDI ruft die DrvGetGlyphMode-Routine eines Treibers auf, um den Bereich der Schriftartinformationen zu bestimmen, die für eine bestimmte Schriftart zwischengespeichert werden sollen. Das heißt, DrvGetGlyphMode bestimmt, was GDI in seinem Schriftartcache speichert. Ein Gerät, das Schriftarten selbst zwischenspeichert, sollte FO_HGLYPHS zurückgeben, um die Speicheranforderungen für die Schriftart zu minimieren.

GDI ruft DrvGetGlyphMode für jede Schriftrealisierung auf. Ein Treiber kann beispielsweise Konturen für Punktgrößen herunterladen, die größer als 12 Punkt sind, aber Rasterbilder für kleinere Schriftarten. GDI behält sich jedoch das Recht vor, diesen Antrag abzulehnen.

Der Treiber muss das RASTER_FONTTYPE Bit des flFontType-Members der FONTOBJ-Struktur überprüfen, um die tatsächliche Form der Glyphen zu bestimmen. Wenn dieses Bit festgelegt ist, sendet GDI Bitmaps; andernfalls werden PATHOBJ-Strukturen gesendet.

Zum Zeitpunkt des Aufrufs von DrvGetGlyphMode ist die zugehörige FONTOBJ nicht voll funktionsfähig. GDI garantiert nur, dass die IFIMETRICS-Struktur und die Notional-to-Device-Transformation korrekt sind.

DrvGetGlyphMode ist eine optionale Treiberfunktion. Wenn diese Funktion nicht bereitgestellt wird, speichert GDI standardmäßig Rasterschriftarten.