Funzione DrvGetGlyphMode (winddi.h)

Articolo
08/27/2023

La funzione DrvGetGlyphMode indica a GDI come memorizzare nella cache le informazioni sul glifo.

Sintassi

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

Parametri

[in] unnamedParam1

Gestire la struttura PDEV di un dispositivo fisico.

[in] unnamedParam2

Puntatore a una struttura FONTOBJ che può essere eseguita una query per trovare le dimensioni, la trasformazione e altri attributi di carattere.

Valore restituito

DrvGetGlyphMode restituisce uno dei valori seguenti:

Codice restituito	Descrizione
FO_GLYPHBITS	GDI deve memorizzare nella cache tutti i dati del glifo per questo tipo di carattere.
FO_HGLYPHS	I tipi di carattere del dispositivo vengono memorizzati nella cache, quindi GDI deve memorizzare nella cache solo glifi per questo tipo di carattere.
FO_PATHOBJ	GDI deve memorizzare nella cache le strutture PATHOBJ per questo tipo di carattere.

Commenti

GDI chiama la routine DrvGetGlyphMode di un driver per determinare l'intervallo di informazioni sul tipo di carattere che devono essere memorizzate nella cache per un tipo di carattere specifico; ovvero DrvGetGlyphMode determina cosa archivia GDI nella cache dei tipi di carattere. Un dispositivo che memorizza nella cache i tipi di carattere da solo deve restituire FO_HGLYPHS per ridurre al minimo i requisiti di archiviazione per il tipo di carattere.

GDI chiama DrvGetGlyphMode per ogni realizzazione del tipo di carattere. Ad esempio, un driver potrebbe voler scaricare i contorni per le dimensioni dei punti superiori a 12 punti, ma le immagini raster per tipi di carattere più piccoli. Tuttavia, GDI riserva il diritto di rifiutare questa richiesta.

Il driver deve controllare il RASTER_FONTTYPE bit del membro flFontType della struttura FONTOBJ per determinare la forma effettiva dei glifi. Se questo bit è impostato, GDI invia bitmap; in caso contrario, invia strutture PATHOBJ .

Al momento della chiamata a DrvGetGlyphMode, fontOBJ associato non è completamente funzionale. GDI garantisce solo che la struttura IFIMETRICS e la trasformazione notional-to-device siano corrette.

DrvGetGlyphMode è una funzione driver facoltativa. Se questa funzione non viene fornita, GDI archivierà i tipi di carattere raster per impostazione predefinita.