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

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

要求

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

另请参阅

IPrintPipelineFilter：：ShutdownOperation

IXpsRasterizer：：RasterizeRect

IXpsRasterizerNotificationCallback