IXpsRasterizerNotificationCallback::Continue 方法 (xpsrassvc.h)

该方法 Continue 告知调用方 (XPS 光栅化服务) 是否继续光栅化当前 XPS 固定页。

语法

HRESULT Continue();

返回值

Continue 返回S_OK,使光栅化能够继续。 否则,该方法将返回错误代码来中止光栅化。 可能的错误返回值包括:

返回代码 说明
HRESULT_FROM_WIN32 (ERROR_PRINT_CANCELLED)
当前打印作业已取消。

备注

此方法由 XPSDrv 筛选器实现。 在页面光栅化操作期间, XPS 光栅化服务 会定期调用此方法以确定是否继续操作。

若要开始页面光栅化操作,XPSDrv 筛选器调用 IXpsRasterizer::RasterizeRect 方法。 通过此调用,筛选器可作为选项提供指向 IXpsRasterizerNotificationCallback 接口实例的指针。 如果提供,RasterizeRect 将在处理 RasterizeRect 调用期间定期在此接口上调用Continue该方法。 如果 Continue 返回成功代码, RasterizeRect 将继续执行光栅化操作。 如果 Continue 返回错误代码, RasterizeRect 会中止光栅化操作并立即返回。

如果用户取消打印作业或在处理打印作业期间发生错误,管道管理器将调用 XPSDrv 筛选器的 IPrintPipelineFilter::ShutdownOperation 方法来关闭筛选器。 通常,如果筛选器实现 Continue 该方法并提供 IXpsRasterizerNotificationCallback 指针到 RasterizeRect,则筛选器可以更及时地完成关闭。

有关方法的示例实现 Continue ,请参阅 WDK 中的 XpsRasFilter 示例。 此示例位于 WDK 安装的 Src\Print\Xpsrasfilter 文件夹中。

要求

   
最低受支持的客户端 在 Windows 7 及更高版本的 Windows 操作系统中受支持。
目标平台 桌面
Header xpsrassvc.h

另请参阅

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback