IXpsRasterizerNotificationCallback::Continue-Methode (xpsrassvc.h)

Die Continue-Methode teilt dem Aufrufer (dem XPS-Rasterungsdienst) mit, ob die aktuelle XPS-Fixseite weiter gerastert werden soll.

Syntax

HRESULT Continue();

Rückgabewert

Continue gibt S_OK zurück, um die Rasterung fortzusetzen. Andernfalls gibt die Methode einen Fehlercode zurück, um die Rasterung abzubrechen. Mögliche Fehlerrückgabewerte sind:

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED)	Der aktuelle Druckauftrag wurde abgebrochen.

Hinweise

Diese Methode wird durch einen XPSDrv-Filter implementiert. Während eines Seitenrastervorgangs ruft der XPS-Rasterungsdienst diese Methode regelmäßig auf, um zu bestimmen, ob der Vorgang fortgesetzt werden soll.

Um einen Seitenrastervorgang zu starten, ruft der XPSDrv-Filter die IXpsRasterizer::RasterizeRect-Methode auf. Mit diesem Aufruf kann der Filter optional einen Zeiger auf eine IXpsRasterizerNotificationCallback-Schnittstelle instance bereitstellen. Wenn angegeben, ruft RasterizeRect während der Verarbeitung des RasterizeRect-Aufrufs regelmäßig die Continue-Methode auf dieser Schnittstelle auf. Wenn Continue einen erfolgreichen Code zurückgibt, setzt RasterizeRect den laufenden Rasterisierungsvorgang fort. Wenn Continue einen Fehlercode zurückgibt, bricht RasterizeRect den Rasterisierungsvorgang ab und gibt sofort zurück.

Wenn der Benutzer einen Druckauftrag abbricht oder während der Verarbeitung eines Druckauftrags ein Fehler auftritt, ruft der Pipeline-Manager die IPrintPipelineFilter::ShutdownOperation-Methode des XPSDrv-Filters auf, um den Filter herunterzufahren. In der Regel kann der Filter das Herunterfahren schneller abschließen, wenn er die Continue-Methode implementiert und einen IXpsRasterizerNotificationCallback-Zeiger auf RasterizeRect bereitstellt.

Eine Beispielimplementierung der Continue-Methode finden Sie im XpsRasFilter-Beispiel im WDK. Dieses Beispiel befindet sich im Ordner Src\Print\Xpsrasfilter in Ihrer WDK-Installation.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in Windows 7 und höheren Versionen des Windows-Betriebssystems.
Zielplattform	Desktop
Kopfzeile	xpsrassvc.h

Weitere Informationen

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback