Função GdiEndPageEMF (winppi.h)

Artigo
02/27/2024

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.

Retornar valor

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

Comentários

A função GdiEndPageEMF é exportada por gdi32.dll para uso dentro da 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 documentos tiver sido colocado na página física, faça chamadas para GdiPlayPageEMF. Observe que GdiPlayPageEMF não é realmente impresso 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 gráficos são impressos no contexto do dispositivo quando GdiEndPageEMF é chamado.
Sempre que uma chamada para GdiGetDevmodeForPage indica que a estrutura 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 estiver 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 coloridas, lembre-se de que a otimização de cores faz com que as marcas d'água coloridas 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 cor controlada pelo parâmetro dwOptimization também pode ser controlada definindo o membro dwColorOptimization das estruturas ATTRIBUTE_INFO_2 ou ATTRIBUTE_INFO_3 . Essa otimização também pode ser controlada pelo atributo de cor Unidrv *ChangeColorModeOnDoc? (consulte Atributos de cor).

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