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 |