Função FONTOBJ_cGetGlyphs (winddi.h)

Artigo
03/13/2024

A função FONTOBJ_cGetGlyphs é um serviço para o consumidor de fonte que converte identificadores de glifo em ponteiros para dados de glifo, que são válidos até a próxima chamada para FONTOBJ_cGetGlyphs.

Sintaxe

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

Parâmetros

pfo

Ponteiro para uma estrutura FONTOBJ que contém as alças de glifo a serem convertidas.

[in] iMode

Especifica se os dados serão gravados como bitmaps ou como objetos de estrutura de tópicos. Esse parâmetro pode usar um dos valores a seguir:

Valor	Significado
FO_GLYPHBITS	Os dados consistirão em estruturas GLYPHBITS que definem os bitmaps dos glifos.
FO_PATHOBJ	Os dados consistirão em estruturas PATHOBJ que definem os contornos dos glifos. Para determinar se o caminho deve ser preenchido ou acarinhado, o consumidor da fonte deve marcar o membro flInfo da estrutura IFIMETRICS. Se o sinalizador FM_INFO_RETURNS_STROKES estiver definido, o caminho deverá ser traçado; caso contrário, o caminho deve ser preenchido.

cGlyph

Especifica o número de glifos a serem convertidos. O único valor aceitável é 1 (o código pressupõe 1, independentemente do valor especificado).

phg

Ponteiro para uma matriz de estruturas HGLYPH de cGlyph fornecidas pelo driver.

ppvGlyph

Ponteiro para um local de memória que recebe o endereço de uma estrutura GLYPHDATA . O primeiro membro dessa estrutura é uma união GLYPHDEF , que contém um ponteiro para uma estrutura GLYPHBITS ou uma estrutura PATHOBJ, dependendo do valor do parâmetro iMode . Se o valor de iMode for FO_GLYPHBITS, (ppvGlyph)->gdf conterá o endereço de uma estrutura GLYPHBITS. Se o valor de iMode for FO_PATHOBJ, (ppvGlyph)->gdf conterá o endereço de uma estrutura PATHOBJ.

Retornar valor

O valor retornado é a contagem de ponteiros passados para o driver se a função for bem-sucedida. Caso contrário, ele será zero e um código de erro será registrado.

Comentários

Essa função deverá ser usada se o driver estiver armazenando fontes em cache.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	winddi.h (inclua Winddi.h)
Biblioteca	Win32k.lib
DLL	Win32k.sys