FONTOBJ_cGetGlyphs

FONTOBJ_cGetGlyphs

ULONG FONTOBJ_cGetGlyphs(

IN FONTOBJ *pfo,
IN ULONG iMode,
IN ULONG cGlyph,
IN HGLYPH *phg,
OUT PVOID **ppvGlyph
);

FONTOBJ_cGetGlyphs is a service to the font consumer that translates glyph handles into pointers to glyph data. These pointers are valid until the next call to FONTOBJ_cGetGlyphs.

Parameters

pfo

Points to a FONTOBJ structure containing the glyph handles to be translated.

iMode

Specifies whether data will be written as bitmaps or as outline objects. This parameter can be one of the following values:

Value	Meaning
FO_GLYPHBITS	Data will consist of GLYPHBITS structures that define the bitmaps of the glyphs.
FO_PATHOBJ	Data will consist of PATHOBJ structures that define the outlines of the glyphs. To determine whether the path should be filled or stroked, the font consumer should check the flInfo member of the IFIMETRICS structure. If the FM_INFO_RETURNS_STROKES flag is set, the path should be stroked; otherwise, the path should be filled.

cGlyph

Specifies the number of glyphs to be translated. This number of glyph handles is available in the array starting at the address specified by phg. There must be enough space allocated in the buffer pointed to by ppvGlyph to store this number of pointers.

phg

Points to an array of cGlyph HGLYPH structures supplied by the driver.

ppvGlyph

Points to a buffer that is to receive cGlyph pointers to GLYPHDATA structures, corresponding to the handles passed in by the driver.

Return Value

The return value is the count of pointers passed to the driver if the function is successful. Otherwise, it is zero, and an error code is logged.

Comments

This function should be used if the driver is caching fonts.