Função DrvQueryFontTree (winddi.h)

Artigo
03/13/2024

A função DrvQueryFontTree fornece à GDI um ponteiro para uma estrutura que define um dos seguintes:

Um mapeamento de Unicode para identificadores de glifo, incluindo variantes de glifo
Um mapeamento de pares de kerning para identificadores de kerning

Sintaxe

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

Parâmetros

dhpdev

Identifica um dispositivo por um identificador para seu PDEV, retornado de uma chamada anterior para DrvEnablePDEV.

iFile

Identifica o arquivo de fonte do driver. Esse valor é retornado por DrvLoadFontFile.

iFace

Especifica o índice baseado em um da fonte do driver.

iMode

Especifica o tipo de informação a ser fornecido. Esse valor pode ser um dos seguintes:

Valor	Significado
QFT_GLYPHSET	A GDI solicita um ponteiro para uma estrutura FD_GLYPHSET que define os mapeamentos de caracteres Unicode únicos para identificadores de glifo.
QFT_KERNPAIRS	A GDI solicita um ponteiro para uma matriz classificada e terminada em nulo de estruturas de FD_KERNINGPAIR . Os pares de kerning devem ser armazenados em ordem crescente. A chave primária é o segundo caractere Unicode; a chave secundária é o primeiro caractere Unicode no par de kerning.

pid

Ponteiro para um local de memória que contém o endereço de um valor definido pelo driver. A GDI passa o conteúdo de *pid para DrvFree, juntamente com o ponteiro retornado, quando a estrutura de FD_GLYPHSET ou a matriz de estruturas FD_KERNINGPAIR não são mais necessárias. Dependendo de como a memória é gerenciada no driver, o valor definido pelo driver pode identificar a estrutura, identificar a maneira como ela foi alocada ou não fazer nada.

Retornar valor

O valor retornado será um ponteiro para a estrutura solicitada se a função for bem-sucedida. Caso contrário, ele será NULL e um código de erro será registrado.