IXpsRasterizerNotificationCallback::Continue 方法 (xpsrassvc.h)

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

语法

HRESULT 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 方法并提供指向 RasterizeRectIXpsRasterizerNotificationCallback 指针,则筛选器可以更及时地完成关闭。

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

要求

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

另请参阅

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback