STROBJ_bEnum function (winddi.h)

Article
02/22/2024

The STROBJ_bEnum function enumerates glyph identities and positions.

Syntax

ENGAPI BOOL STROBJ_bEnum(
  STROBJ    *pstro,
  ULONG     *pc,
  PGLYPHPOS *ppgpos
);

Parameters

pstro

Pointer to the STROBJ structure containing the GLYPHPOS information.

pc

Pointer to the count, returned by GDI, of GLYPHPOS structures.

ppgpos

Pointer to the array in which GDI writes the GLYPHPOS structures.

Return value

The return value is TRUE if more glyphs remain to be enumerated, or FALSE if the enumeration is complete. The return value is DDI_ERROR if the glyphs cannot be enumerated, and an error code is logged.

Remarks

A driver should download only the glyph handles if it caches fonts itself.

The information returned depends on the driver's return value for DrvGetGlyphMode.

Bitmaps or outlines can also be obtained from FONTOBJ structures.

Printer drivers should call STROBJ_bEnumPositionsOnly instead of STROBJ_bEnum if printer hardware provides internal rendering of TrueType fonts.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys

Share via