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

El método Continue indica al autor de la llamada (el servicio de rasterización XPS) si desea continuar rasterizando la página fija actual de XPS.

Sintaxis

HRESULT Continue();

Valor devuelto

Continue devuelve S_OK para permitir que la rasterización continúe. De lo contrario, el método devuelve un código de error para anular la rasterización. Entre los posibles valores devueltos de error se incluyen:

Código devuelto	Descripción
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED)	Se ha cancelado el trabajo de impresión actual.

Comentarios

Este método se implementa mediante un filtro XPSDrv. Durante una operación de rasterización de páginas, el servicio de rasterización XPS llama periódicamente a este método para determinar si desea continuar con la operación.

Para iniciar una operación de rasterización de páginas, el filtro XPSDrv llama al método IXpsRasterizer::RasterizeRect . Con esta llamada, el filtro puede, como opción, proporcionar un puntero a una instancia de interfaz IXpsRasterizerNotificationCallback . Si se proporciona, RasterizeRect llamará periódicamente al método Continue en esta interfaz durante el procesamiento de la llamada a RasterizeRect . Si Continue devuelve un código correcto, RasterizeRect continúa con la operación de rasterización en curso. Si Continue devuelve un código de error, RasterizeRect anula la operación de rasterización y devuelve inmediatamente.

Si el usuario cancela un trabajo de impresión o si se produce un error durante el procesamiento de un trabajo de impresión, el administrador de canalizaciones llama al método IPrintPipelineFilter::ShutdownOperation del filtro XPSDrv para apagar el filtro. Normalmente, el filtro puede completar el apagado de forma más oportuna si implementa el método Continue y proporciona un puntero IXpsRasterizerNotificationCallback a RasterizeRect.

Para obtener un ejemplo de implementación del método Continue , vea el ejemplo XpsRasFilter en WDK. Este ejemplo se encuentra en la carpeta Src\Print\Xpsrasfilter de la instalación de WDK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con Windows 7 y versiones posteriores del sistema operativo Windows.
Plataforma de destino	Escritorio
Encabezado	xpsrassvc.h

Consulte también

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback