Hardware Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize

FONTOBJ_cGetGlyphs function

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

Syntax


ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  _In_ ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

Parameters

pfo

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

iMode [in]

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

ValueMeaning

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. The only acceptable value is 1 (the code assumes 1, regardless of the value specified).

phg

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

ppvGlyph

Pointer to a memory location that receives the address of a GLYPHDATA structure. The first member of this structure is a GLYPHDEF union, which contains a pointer to either a GLYPHBITS structure or a PATHOBJ structure, depending on the value of the iMode parameter. If the value of iMode is FO_GLYPHBITS, (*ppvGlyph)->gdf contains the address of a GLYPHBITS structure. If the value of iMode is FO_PATHOBJ, (*ppvGlyph)->gdf contains the address of a PATHOBJ structure.

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.

Remarks

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

Requirements

Target platform

Universal

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

DrvGetGlyphMode
FONTOBJ
FONTOBJ_cGetAllGlyphHandles
GLYPHBITS
IFIMETRICS
PATHOBJ

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft