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 オペレーティング システムでサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | xpsrassvc.h |