Função de retorno de chamada PFNGETINFO (printoem.h)

Artigo
02/07/2025

A função de retorno de chamada UNIFONTOBJ_GetInfo é fornecida pelo driver Unidrv para que os plug-ins de renderização possam obter informações de fonte ou glifo.

Sintaxe

PFNGETINFO Pfngetinfo;

BOOL Pfngetinfo(
  _UNIFONTOBJ *unnamedParam1,
  DWORD unnamedParam2,
  PVOID unnamedParam3,
  DWORD unnamedParam4,
  PDWORD unnamedParam5
)
{...}

Parâmetros

unnamedParam1

Ponteiro para a estrutura UNIFONTOBJ recebida pela função que está fazendo o retorno de chamada para UNIFONTOBJ_GetInfo. Fornecido pelo chamador.

unnamedParam2

Especifica o tamanho, em bytes, do buffer apontado por pData. Fornecido pelo chamador.

unnamedParam3

Ponteiro para uma estrutura, conforme indicado na tabela a seguir. Fornecido pelo chamador.

Valor dwInfoID	estrutura de pData
UFO_GETINFO_FONTOBJ	GETINFO_FONTOBJ
UFO_GETINFO_GLYPHBITMAP	GETINFO_GLYPHBITMAP
UFO_GETINFO_GLYPHSTRING	GETINFO_GLYPHSTRING
UFO_GETINFO_GLYPHWIDTH	GETINFO_GLYPHWIDTH
UFO_GETINFO_MEMORY	GETINFO_MEMORY
UFO_GETINFO_STDVARIABLE	GETINFO_STDVAR

Para obter mais informações, consulte a tabela na seção Comentários.

unnamedParam4

Especifica o tipo de estrutura apontado por pData. Fornecido pelo chamador. Para obter mais informações, consulte a tabela na seção Comentários.

unnamedParam5

Ponteiro para um local que recebe o tamanho mínimo do buffer, em bytes, necessário para conter a estrutura identificada por dwInfoID. Fornecido pelo chamador.

Valor de retorno

Retorna um valor BOOL. Se a operação for bem-sucedida, a função retornará VERDADEIRO. Caso contrário, ele retornará FALSE.

Observações

A função de retorno de chamada UNIFONTOBJ_GetInfo permite que um de plug-in de renderização chame novamente no Unidrv para obter informações de fonte ou glifo da GDI, necessárias para lidar com operações de gerenciamento de fontes personalizadas.

Um plug-in de renderização recebe o endereço da função UNIFONTOBJ_GetInfo na estrutura UNIFONTOBJ que é passada para os métodos de personalização de fonte.

O tipo de informação retornada pela função depende dos argumentos de entrada. O chamador fornece valores para dwInfoID, pDatae dwDataSize para indicar o tipo de informação desejada. A tabela a seguir resume os tipos de informações retornadas. Para obter mais informações, consulte as descrições da estrutura.

estrutura de pData	Informações retornadas
GETINFO_FONTOBJ	Uma estrutura FONTOBJ que descreve a fonte atual.
GETINFO_GLYPHBITMAP	Um único bitmap de glifo.
GETINFO_GLYPHSTRING	Uma matriz de especificadores de glifo em um formato especificado.
GETINFO_GLYPHWIDTH	Largura total de um conjunto de glifos.
GETINFO_MEMORY	Quantidade de memória da impressora disponível restante.
GETINFO_STDVAR	O valor atual de uma ou mais variáveis padrão unidrv.

Se o buffer descrito por pData e dwDataSize for muito pequeno para receber a estrutura indicada por dwInfoID, a função carregará o tamanho do buffer necessário no local apontado por pcbNeeded e retornará false.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	printoem.h (inclua Printoem.h)

Partilhar via