función FONTOBJ_cGetGlyphs (winddi.h)

Artículo
03/04/2024

La función FONTOBJ_cGetGlyphs es un servicio para el consumidor de fuentes que traduce los identificadores de glifo en punteros a datos de glifo, que son válidos hasta la siguiente llamada a FONTOBJ_cGetGlyphs.

Sintaxis

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

Parámetros

pfo

Puntero a una estructura FONTOBJ que contiene los identificadores de glifo que se van a traducir.

[in] iMode

Especifica si los datos se escribirán como mapas de bits o como objetos de esquema. Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
FO_GLYPHBITS	Los datos constarán de estructuras GLYPHBITS que definen los mapas de bits de los glifos.
FO_PATHOBJ	Los datos constarán de estructuras PATHOBJ que definen los contornos de los glifos. Para determinar si la ruta de acceso debe rellenarse o trazo, el consumidor de fuentes debe comprobar el miembro flInfo de la estructura IFIMETRICS . Si se establece la marca FM_INFO_RETURNS_STROKES, se debe trazar la ruta de acceso; de lo contrario, se debe rellenar la ruta de acceso.

cGlyph

Especifica el número de glifos que se van a traducir. El único valor aceptable es 1 (el código supone 1, independientemente del valor especificado).

phg

Puntero a una matriz de estructuras HGLYPH cGlyph proporcionadas por el controlador.

ppvGlyph

Puntero a una ubicación de memoria que recibe la dirección de una estructura GLYPHDATA . El primer miembro de esta estructura es una unión GLYPHDEF , que contiene un puntero a una estructura GLYPHBITS o una estructura PATHOBJ, dependiendo del valor del parámetro iMode . Si el valor de iMode es FO_GLYPHBITS, (ppvGlyph)->gdf contiene la dirección de una estructura GLYPHBITS. Si el valor de iMode es FO_PATHOBJ, (ppvGlyph)->gdf contiene la dirección de una estructura PATHOBJ.

Valor devuelto

El valor devuelto es el recuento de punteros pasados al controlador si la función es correcta. De lo contrario, es cero y se registra un código de error.

Comentarios

Esta función se debe usar si el controlador almacena fuentes en caché.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys