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 7 及更高版本的 Windows作系统中受支持。
目标平台 桌面
标头 xpsrassvc.h

另请参阅

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback