Método IXpsRasterizerNotificationCallback::Continue (xpsrassvc.h)
O método Continue informa ao chamador (o serviço de rasterização XPS) se deve continuar rasterizando a página fixa XPS atual.
Sintaxe
HRESULT Continue();
Valor de retorno
Continuar 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 valores de retorno de erro possíveis incluem:
| Código de retorno | Descrição |
|---|---|
| HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED) | O trabalho de impressão atual foi cancelado. |
Observações
Esse método é implementado por um filtro XPSDrv. Durante uma operação de rasterização de página, o serviço de rasterização do XPS chama periodicamente esse método para determinar se a operação deve continuar.
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 de 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 do filtro XPSDrv::ShutdownOperation para desligar o filtro. Normalmente, o filtro pode concluir o desligamento de uma 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 |
|---|---|
| de cliente com suporte mínimo | Com suporte no Windows 7 e versões posteriores do sistema operacional Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | xpsrassvc.h |