función FONTOBJ_cGetGlyphs (winddi.h)
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 |