Método IXpsRasterizerNotificationCallback::Continue (xpsrassvc.h)

O método Continue informa ao chamador (o serviço de rasterização XPS) se deseja continuar rasterizando a página fixa XPS atual.

Sintaxe

HRESULT Continue();

Retornar valor

Continue retorna S_OK para permitir que a rasterização continue. Caso contrário, o método retorna um código de erro para anular a rasterização. Os possíveis valores retornados por erro incluem:

Código de retorno	Descrição
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED)	O trabalho de impressão atual foi cancelado.

Comentários

Esse método é implementado por um filtro XPSDrv. Durante uma operação de rasterização de página, o serviço de rasterização XPS chama periodicamente esse método para determinar se deseja continuar a operação.

Para iniciar uma operação de rasterização de página, o filtro XPSDrv chama o método IXpsRasterizer::RasterizeRect . Com essa chamada, o filtro pode, como opção, fornecer um ponteiro para uma instância da interface IXpsRasterizerNotificationCallback . Se fornecido, RasterizeRect chamará periodicamente o método Continue nessa interface durante o processamento da chamada RasterizeRect . Se Continuar retornar um código de êxito, RasterizeRect continuará com a operação de rasterização em andamento. Se Continuar retornar um código de erro, RasterizeRect anulará a operação de rasterização e retornará imediatamente.

Se o usuário cancelar um trabalho de impressão ou se ocorrer um erro durante o processamento de um trabalho de impressão, o gerenciador de pipeline chamará o método IPrintPipelineFilter::ShutdownOperation do filtro XPSDrv para desligar o filtro. Normalmente, o filtro pode concluir o desligamento de maneira mais oportuna se implementar o método Continue e fornecer um ponteiro IXpsRasterizerNotificationCallback para RasterizeRect.

Para obter um exemplo de implementação do método Continue , consulte o exemplo XpsRasFilter no WDK. Este exemplo está localizado na pasta Src\Print\Xpsrasfilter na instalação do WDK.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no Windows 7 e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	xpsrassvc.h

Confira também

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback