IXpsRasterizerNotificationCallback::Continue メソッド (xpsrassvc.h)
Continue メソッドは、現在の XPS 固定ページをラスター化し続けるかどうかを呼び出し元 (XPS ラスター化サービス) に指示します。
構文
HRESULT Continue();
戻り値
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 オペレーティング システムでサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | xpsrassvc.h |