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