Función DrvQueryFontTree (winddi.h)

Artículo
03/13/2024

La función DrvQueryFontTree proporciona GDI con un puntero a una estructura que define una de las siguientes opciones:

Asignación de unicode a identificadores de glifo, incluidas variantes de glifo
Asignación de pares de inter kerning a identificadores de kerning

Sintaxis

PVOID DrvQueryFontTree(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG     iMode,
  ULONG_PTR *pid
);

Parámetros

dhpdev

Identifica un dispositivo por un identificador a su PDEV, devuelto desde una llamada anterior a DrvEnablePDEV.

iFile

Identifica el archivo de fuente del controlador. DrvLoadFontFile devuelve este valor.

iFace

Especifica el índice basado en uno de la fuente del controlador.

iMode

Especifica el tipo de información que se va a proporcionar. Puede ser uno de los siguientes valores:

Valor	Significado
QFT_GLYPHSET	GDI solicita un puntero a una estructura de FD_GLYPHSET que define las asignaciones de caracteres Unicode individuales a identificadores de glifo.
QFT_KERNPAIRS	GDI solicita un puntero a una matriz ordenada terminada en null de estructuras de FD_KERNINGPAIR . Los pares de inter kerning deben almacenarse en orden creciente. La clave principal es el segundo carácter Unicode; la clave secundaria es el primer carácter Unicode del par de inter kerning.

pid

Puntero a una ubicación de memoria que contiene la dirección de un valor definido por el controlador. GDI pasa el contenido de *pid a DrvFree, junto con el puntero devuelto, cuando la estructura o matriz de FD_GLYPHSET FD_KERNINGPAIR estructuras ya no son necesarias. En función de cómo se administre la memoria en el controlador, el valor definido por el controlador puede identificar la estructura, identificar la forma en que se asignó o no hacer nada en absoluto.

Valor devuelto

El valor devuelto es un puntero a la estructura solicitada si la función se realiza correctamente. De lo contrario, es NULL y se registra un código de error.