IXpsRasterizerNotificationCallback ::Continue, méthode (xpsrassvc.h)
La méthode Continuer indique à l’appelant (le service de rastérisation XPS) s’il faut continuer à rastériser la page fixe XPS actuelle.
Syntaxe
HRESULT Continue();
Valeur de retour
Continuer 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 :
| Retourner le code | 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 continuer 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 tant qu’option, fournir un pointeur vers une instance d’interface IXpsRasterizerNotificationCallback. Si elle est fournie, RasterizeRect appelle régulièrement la méthode Continuer sur cette interface pendant le traitement de l’appel RasterizeRect. Si Continuer retourne un code de réussite, RasterizeRect continue avec l’opération de rastérisation en cours. Si Continuer retourne 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 pipeline appelle la méthode IPrintPipelineFilter ::ShutdownOperation du filtre pour arrêter le filtre. En règle générale, le filtre peut terminer l’arrêt en temps voulu s’il implémente la méthode Continuer et fournit une IXpsRasterizerNotificationCallback pointeur vers RasterizeRect.
Pour obtenir un exemple d’implémentation de la méthode Continuer, consultez l’exemple XpsRasFilter dans wdK. Cet exemple se trouve dans le dossier Src\Print\Xpsrasfilter de votre installation WDK.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge dans Windows 7 et versions ultérieures du système d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | xpsrassvc.h |
Voir aussi
IPrintPipelineFilter ::ShutdownOperation