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 |