Metodo IXpsRasterizerNotificationCallback::Continue (xpsrassvc.h)

Il metodo Continue indica al chiamante (il servizio di rasterizzazione XPS) se continuare a rasterizzare la pagina fissa XPS corrente.

Sintassi

HRESULT Continue();

Valore restituito

Continua restituisce S_OK per consentire la continuazione della rasterizzazione. In caso contrario, il metodo restituisce un codice di errore per interrompere la rasterizzazione. I valori restituiti di errore possibili includono:

Codice restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED)	Il processo di stampa corrente è stato annullato.

Commenti

Questo metodo viene implementato da un filtro XPSDrv. Durante un'operazione di rasterizzazione di pagine, il servizio di rasterizzazione XPS chiama periodicamente questo metodo per determinare se continuare l'operazione.

Per avviare un'operazione di rasterizzazione di pagine, il filtro XPSDrv chiama il metodo IXpsRasterizer::RasterizeRect . Con questa chiamata, il filtro può, come opzione, fornire un puntatore a un'istanza dell'interfaccia IXpsRasterizerNotificationCallback . Se specificato, RasterizeRect chiamerà periodicamente il metodo Continue su questa interfaccia durante l'elaborazione della chiamata RasterizeRect . Se Continue restituisce un codice riuscito, RasterizeRect continua con l'operazione di rasterizzazione in corso. Se Continue restituisce un codice di errore, RasterizeRect interrompe l'operazione di rasterizzazione e restituisce immediatamente.

Se l'utente annulla un processo di stampa o se si verifica un errore durante l'elaborazione di un processo di stampa, gestione pipeline chiama il metodo IPrintPipelineFilter::ShutdownOperation del filtro XPSDrv per arrestare il filtro. In genere, il filtro può completare l'arresto in modo più tempestivo se implementa il metodo Continue e fornisce un puntatore IXpsRasterizerNotificationCallback a RasterizeRect.

Per un esempio di implementazione del metodo Continue , vedere l'esempio XpsRasFilter in WDK. Questo esempio si trova nella cartella Src\Print\Xpsrasfilter nell'installazione di WDK.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in Windows 7 e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Desktop
Intestazione	xpsrassvc.h

Vedi anche

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback