Método IPrintOemUni::D ownloadFontHeader (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemUni::DownloadFontHeader permite que um plug-in de renderização para Unidrv envie informações de cabeçalho de uma fonte para uma impressora.

Sintaxe

HRESULT DownloadFontHeader(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [out] OUT DWORD   *pdwResult
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura de DEVOBJ.

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura de UNIFONTOBJ.

[out] pdwResult

Recebe um valor fornecido pelo método que representa a quantidade de memória da impressora, em bytes, necessária para armazenar as informações do cabeçalho da fonte. Se a operação falhar, o valor retornado deverá ser zero.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação
E_NOTIMPL	O método não é implementado.

Observações

O método IPrintOemUni::DownloadFontHeader é usado para dar suporte a fontes suaves em impressoras que não aceitam comandos PCL. Sua finalidade é permitir que um plug-in de renderização obtenha informações de cabeçalho de fonte da Unidrv e envie as informações para a impressora.

Informações que podem ser necessárias para a construção de um cabeçalho de fontePCL não podem ser obtidas por:

Referenciando a estrutura UNIFONTOBJ que é recebida como um argumento de entrada.
Chamando a função de retorno de chamada UNIFONTOBJ_GetInfo para obter a estrutura FONTOBJ da fonte.

O método deve enviar as informações de cabeçalho para o spooler chamando IPrintOemDriverUni::D rvWriteSpoolBuf.

O método IPrintOemUni::DownloadFontHeader é opcional. Se um plug-in de renderização implementar esse método, o método IPrintOemUni::GetImplementedMethod do plug-in deverá retornar S_OK quando receber "DownloadFontHeader" como entrada.

Se você implementar o método IPrintOemUni::DownloadFontHeader, também deverá implementar o método IPrintOemUni::D ownloadCharGlyph.

Para obter informações adicionais, consulte de Gerenciamento de Fontes Personalizado.

Requisitos

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

Compartilhar via