Share via

Méthode IXpsRasterizerNotificationCallback ::Continue (xpsrassvc.h)

  • Article

La méthode Continue indique à l’appelant (le service de rastérisation XPS) s’il faut poursuivre la rastérisation de la page fixe XPS actuelle.

Syntaxe

HRESULT Continue();

Valeur de retour

Continue retourne S_OK pour permettre à la rastérisation de continuer. Sinon, la méthode retourne un code d’erreur pour abandonner la rastérisation. Les valeurs de retour d’erreur possibles sont les suivantes :

Code de retour Description
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED) Le travail d’impression actuel a été annulé.

Remarques

Cette méthode est implémentée par un filtre XPSDrv. Pendant une opération de rastérisation de page, le service de rastérisation XPS appelle régulièrement cette méthode pour déterminer s’il faut poursuivre l’opération.

Pour commencer une opération de rastérisation de page, le filtre XPSDrv appelle la méthode IXpsRasterizer ::RasterizeRect . Avec cet appel, le filtre peut, en option, fournir un pointeur vers une interface IXpsRasterizerNotificationCallback instance. Si elle est fournie, RasterizeRect appelle régulièrement la méthode Continue sur cette interface pendant le traitement de l’appel RasterizeRect . Si Continue retourne un code de réussite, RasterizeRect poursuit l’opération de rastérisation en cours. Si Continue renvoie un code d’erreur, RasterizeRect abandonne l’opération de rastérisation et retourne immédiatement.

Si l’utilisateur annule un travail d’impression ou si une erreur se produit pendant le traitement d’un travail d’impression, le gestionnaire de pipelines appelle la méthode IPrintPipelineFilter ::ShutdownOperation du filtre XPSDrv pour arrêter le filtre. En règle générale, le filtre peut terminer l’arrêt plus rapidement s’il implémente la méthode Continue et fournit un pointeur IXpsRasterizerNotificationCallback vers RasterizeRect.

Pour obtenir un exemple d’implémentation de la méthode Continue , consultez l’exemple XpsRasFilter dans wdK. Cet exemple se trouve dans le dossier Src\Print\Xpsrasfilter de votre installation WDK.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans Windows 7 et versions ultérieures du système d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête xpsrassvc.h

Voir aussi

IPrintPipelineFilter ::ShutdownOperation

IXpsRasterizer ::RasterizeRect

IXpsRasterizerNotificationCallback