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 |