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 |