Função DrvGetGlyphMode (winddi.h)

Artigo
03/09/2024

A função DrvGetGlyphMode informa à GDI como armazenar em cache informações de glifo.

Sintaxe

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

Parâmetros

[in] unnamedParam1

Manipule para a estrutura PDEV de um dispositivo físico.

[in] unnamedParam2

Ponteiro para uma estrutura FONTOBJ que pode ser consultada para localizar o tamanho da fonte, a transformação e outros atributos de fonte.

Retornar valor

DrvGetGlyphMode retorna um dos seguintes valores:

Código de retorno	Descrição
FO_GLYPHBITS	O GDI deve armazenar em cache todos os dados de glifo para essa fonte.
FO_HGLYPHS	O dispositivo armazena fontes em cache por conta própria, portanto, a GDI deve armazenar em cache apenas identificadores de glifo para essa fonte.
FO_PATHOBJ	O GDI deve armazenar em cache estruturas PATHOBJ para essa fonte.

Comentários

A GDI chama a rotina DrvGetGlyphMode de um driver para determinar o intervalo de informações de fonte que devem ser armazenadas em cache para uma fonte específica; ou seja, DrvGetGlyphMode determina o que o GDI armazena em seu cache de fontes. Um dispositivo que armazena fontes em cache por conta própria deve retornar FO_HGLYPHS para minimizar os requisitos de armazenamento para a fonte.

A GDI chama DrvGetGlyphMode para cada realização de fonte. Por exemplo, um driver pode querer baixar estruturas de tópicos para tamanhos de ponto maiores que 12 pontos, mas imagens de raster para fontes menores. No entanto, a GDI reserva-se o direito de recusar essa solicitação.

O driver deve marcar o bit RASTER_FONTTYPE do membro flFontType da estrutura FONTOBJ para determinar a forma real dos glifos. Se esse bit estiver definido, a GDI enviará bitmaps; caso contrário, ele está enviando estruturas PATHOBJ .

No momento da chamada para DrvGetGlyphMode, o FONTOBJ associado não está totalmente funcional. O GDI garante apenas que a estrutura IFIMETRICS e a transformação nocional para dispositivo estejam corretas.

DrvGetGlyphMode é uma função de driver opcional. Se essa função não for fornecida, a GDI armazenará fontes de raster por padrão.