Метод IXpsRasterizerNotificationCallback::Continue (xpsrassvc.h)

Метод Continue сообщает вызывающей (службе растеризации XPS), следует ли продолжать растеризацию текущей фиксированной страницы XPS.

Синтаксис

HRESULT Continue();

Возвращаемое значение

Функция Continue возвращает S_OK, чтобы продолжить растеризацию. В противном случае метод возвращает код ошибки для прерывания растеризации. Возможные возвращаемые значения ошибок:

Код возврата	Описание
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED)	Текущее задание печати отменено.

Комментарии

Этот метод реализуется фильтром XPSDrv. Во время операции растеризации страницы служба растеризации XPS периодически вызывает этот метод, чтобы определить, следует ли продолжать операцию.

Чтобы начать операцию растеризации страницы, фильтр XPSDrv вызывает метод IXpsRasterizer::RasterizeRect . При этом вызове фильтр может в качестве параметра предоставить указатель на экземпляр интерфейса IXpsRasterizerNotificationCallback . Если он указан, RasterizeRect будет периодически вызывать метод Continue для этого интерфейса во время обработки вызова RasterizeRect . Если Функция Continue возвращает код успешного выполнения, RasterizeRect продолжает выполнение операции растеризации. Если функция Продолжить возвращает код ошибки, RasterizeRect прерывает операцию растеризации и немедленно возвращается.

Если пользователь отменяет задание печати или возникает ошибка во время обработки задания печати, диспетчер конвейера вызывает метод IPrintPipelineFilter::ShutdownOperation фильтра XPSDrv для завершения работы фильтра. Как правило, фильтр может завершить завершение работы более своевременно, если он реализует метод Continue и предоставляет указатель IXpsRasterizerNotificationCallbackдля RasterizeRect.

Пример реализации метода Continue см. в примере XpsRasFilter в WDK. Этот пример находится в папке Src\Print\Xpsrasfilter в вашей установке WDK.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в Windows 7 и более поздних версиях операционной системы Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	xpsrassvc.h

См. также раздел

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback