Méthode IXpsRasterizerNotificationCallback ::Continue (xpsrassvc.h)
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