Función DrvQueryFontData (winddi.h)

Artículo
08/27/2023

La función DrvQueryFontData recupera información sobre una fuente realizada.

Sintaxis

LONG DrvQueryFontData(
        DHPDEV    dhpdev,
        FONTOBJ   *pfo,
        ULONG     iMode,
        HGLYPH    hg,
        GLYPHDATA *pgd,
  [out] PVOID     pv,
        ULONG     cjSize
);

Parámetros

dhpdev

Controle el PDEV del dispositivo físico que se devolvió desde una llamada anterior a DrvEnablePDEV.

pfo

Puntero a una estructura FONTOBJ que define la realización de fuentes.

iMode

Especifica el tipo de información solicitada. Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
QFD_GLYPHANDBITMAP	Si pgd no es NULL, el controlador debe rellenar la estructura GLYPHDATA con las métricas del glifo especificado por hg. Si pv no es NULL, se debe escribir una estructura GLYPHBITS en esta dirección. El controlador debe copiar el mapa de bits del glifo correspondiente al glifo especificado por hg en esta estructura. El tamaño de la estructura se especifica mediante cjSize. Si el controlador no admite mapas de bits de glifo, solo se llamará a esta función con pv establecido en NULL. Si el controlador admite mapas de bits de glifo, el valor devuelto es el tamaño, en bytes, del mapa de bits del glifo. De lo contrario, es cero. Este modo debe admitirse.
QFD_GLYPHANDOUTLINE	Si pgd no es NULL, el controlador debe rellenar la estructura GLYPHDATA con las métricas del glifo especificado por hg. Si pv no es NULL, se debe escribir una estructura PATHOBJ en esta dirección. El controlador pasa este PATHOBJ a los servicios PATHOBJ_Xxx para crear el esquema para el glifo especificado por hg. Se debe omitir el parámetro cjSize . El valor devuelto es cero si la función se realiza correctamente. De lo contrario, es FD_ERROR. Solo los controladores de fuente que proporcionan esquemas de glifo deben admitir este modo.
QFD_MAXEXTENTS	Si pv no es NULL, el controlador debe escribir una estructura de FD_DEVICEMETRICS en el búfer al que apunta pv. El valor devuelto es el tamaño, en bytes, necesario para el búfer si pv es NULL.
QFD_TT_GRAY1_BITMAP	La fuente realizada debe representarse en un bit por píxel de escala de grises (es decir, blanco o negro).
QFD_TT_GRAY2_BITMAP	La fuente realizada debe representarse en dos bits por píxel de escala de grises.
QFD_TT_GRAY4_BITMAP	La fuente realizada debe representarse en cuatro bits por píxel de escala de grises.
QFD_TT_GRAY8_BITMAP	La fuente realizada debe representarse en ocho bits por píxel de escala de grises.
QFD_TT_MONO_BITMAP	Igual que QFD_TT_GRAY1_BITMAP.

hg

Controle el glifo.

pgd

Puntero a la estructura GLYPHDATA . Este parámetro puede ser NULL.

[out] pv

Puntero a un búfer de datos. El tipo de datos escritos en este búfer depende de iMode. Este parámetro puede ser NULL.

cjSize

Especifica el tamaño del búfer al que apunta pv.

Valor devuelto

El valor devuelto depende del valor del parámetro iMode . Si se produce un error, se FD_ERROR el valor devuelto y se registra un código de error.

Comentarios

Para los valores QFD_GLYPHANDBITMAP y QFD_GLYPHANDOUTLINE del parámetro iMode , GDI proporciona un puntero a una estructura GLYPHDATA (en el parámetro pgd ). El controlador coloca información sobre las métricas de glifo en esta estructura y escribe el contenido de una estructura GLYPHBITS o una estructura PATHOBJ en la ubicación especificada por el parámetro pv , dependiendo respectivamente, de si la fuente es una fuente de mapa de bits o una fuente de esquema. Para el valor QFD_MAXEXTENTS del parámetro iMode , el controlador escribe el contenido de una estructura FD_DEVICEMETRICS en la ubicación especificada por el parámetro pv .

DrvQueryFontData es necesario para los controladores de fuente y los controladores que usan fuentes específicas del dispositivo o específicas del controlador.