funzione FONTOBJ_cGetGlyphs (winddi.h)

Articolo
03/13/2024

La funzione FONTOBJ_cGetGlyphs è un servizio per il consumer di tipi di carattere che converte gli handle di glifo in puntatori ai dati del glifo, validi fino alla chiamata successiva a FONTOBJ_cGetGlyphs.

Sintassi

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

Parametri

pfo

Puntatore a una struttura FONTOBJ contenente gli handle di glifo da convertire.

[in] iMode

Specifica se i dati verranno scritti come bitmap o come oggetti struttura. Questo parametro può essere uno dei valori seguenti:

Valore	Significato
FO_GLYPHBITS	I dati saranno costituiti da strutture GLYPHBITS che definiscono le bitmap dei glifi.
FO_PATHOBJ	I dati saranno costituiti da strutture PATHOBJ che definiscono i contorni dei glifi. Per determinare se il percorso deve essere riempito o tracciato, il consumer del tipo di carattere deve controllare il membro flInfo della struttura IFIMETRICS . Se il flag FM_INFO_RETURNS_STROKES è impostato, il percorso deve essere tracciato; in caso contrario, il percorso deve essere compilato.

cGlyph

Specifica il numero di glifi da tradurre. L'unico valore accettabile è 1 (il codice presuppone 1, indipendentemente dal valore specificato).

phg

Puntatore a una matrice di strutture CGlyph HGLYPH fornite dal driver.

ppvGlyph

Puntatore a una posizione di memoria che riceve l'indirizzo di una struttura GLYPHDATA . Il primo membro di questa struttura è un'unione GLYPHDEF , che contiene un puntatore a una struttura GLYPHBITS o a una struttura PATHOBJ, a seconda del valore del parametro iMode . Se il valore di iMode è FO_GLYPHBITS, (ppvGlyph)->gdf contiene l'indirizzo di una struttura GLYPHBITS. Se il valore di iMode è FO_PATHOBJ, (ppvGlyph)->gdf contiene l'indirizzo di una struttura PATHOBJ.

Valore restituito

Il valore restituito è il conteggio dei puntatori passati al driver se la funzione ha esito positivo. In caso contrario, è zero e viene registrato un codice di errore.

Commenti

Questa funzione deve essere utilizzata se il driver memorizza nella cache i tipi di carattere.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys