Função GdiEndPageEMF (winppi.h)

Artigo
02/07/2025

A função GdiEndPageEMF encerra as operações de reprodução do EMF para uma página física de um trabalho de impressão formatado em EMF.

Sintaxe

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Parâmetros

SpoolFileHandle

Identificador de arquivo de spool fornecido pelo chamador, obtido por uma chamada anterior para GdiGetSpoolFileHandle.

dwOptimization

Sinalizadores fornecidos pelo chamador. O seguinte sinalizador é definido:

EMF_PP_COLOR_OPTIMIZATION

Habilitar a otimização de cores. Para obter mais informações, consulte Comentários.

Valor de retorno

Se a operação for bem-sucedida, a função retornará VERDADEIRO. Caso contrário, a função retornará FALSE e um código de erro poderá ser obtido chamando GetLastError.

Observações

A função GdiEndPageEMF é exportada por gdi32.dll para uso na função PrintDocumentOnPrintProcessor de um processador de impressão.

A função GdiEndPageEMF encerra o processamento de uma página física e faz com que ela seja ejetada da impressora. Um processador de impressão deve chamar GdiEndPageEMF nos seguintes horários:

Depois que o número apropriado de páginas de documento tiver sido colocado na página física, faça chamadas para GdiPlayPageEMF. Observe que GdiPlayPageEMF não imprime no contexto do dispositivo, mas prepara uma estrutura de dados que descreve o texto e os elementos gráficos que devem ser impressos nas páginas físicas. O texto e os elementos gráficos são impressos no contexto do dispositivo quando GdiEndPageEMF é chamado.
Sempre que uma chamada para GdiGetDevmodeForPage indica que a estrutura de DEVMODEW de uma página de documento é diferente da estrutura DEVMODE da página anterior.

Se essa função for chamada com o parâmetro dwOptimization definido como EMF_PP_COLOR_OPTIMIZATION, a otimização de cores será habilitada. Se dwOptimization for definido como 0, nenhuma otimização será executada. Quando a otimização de cores está habilitada, a presença de cor no arquivo de spool faz com que o arquivo de spool seja reproduzido em cores; a falta de cor no arquivo de spool faz com que o arquivo de spool seja reproduzido em monocromático.

Se você estiver criando um plug-in de renderização Unidrv para gerar marcas d'água de cor, lembre-se de que a otimização de cores faz com que as marcas d'água de cores sejam impressas em preto e branco quando são impressas em documentos em preto e branco. Para garantir que as marcas d'água coloridas imprimam corretamente com documentos de cor e preto e branco, desabilite a otimização de cores.

A otimização de cores controlada pelo parâmetro dwOptimization também pode ser controlada definindo o dwColorOptimization membro das estruturas ATTRIBUTE_INFO_2 ou ATTRIBUTE_INFO_3. Essa otimização também pode ser controlada pelo Unidrv *ChangeColorModeOnDoc? atributo de cor (consulte Atributos de Cor).

Para obter informações adicionais, consulte Usando funções GDI em processadores de impressão.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	winppi.h (inclua Winppi.h)
biblioteca	Gdi32.Lib
de DLL	Gdi32.dll

Consulte também

GdiPlayPageEMF

GdiStartPageEMF

Partilhar via