IXpsRasterizerNotificationCallback::Continue 메서드(xpsrassvc.h)

  • 아티클

Continue 메서드는 호출자(XPS 래스터화 서비스)에게 현재 XPS 고정 페이지를 계속 래스터화할지 여부를 알려줍니다.

구문

HRESULT Continue();

반환 값

Continue 는 래스터화를 계속할 수 있도록 S_OK 반환합니다. 그렇지 않으면 메서드는 래스터화를 중단하는 오류 코드를 반환합니다. 가능한 오류 반환 값은 다음과 같습니다.

반환 코드 설명
HRESULT_FROM_WIN32(ERROR_PRINT_CANCELLED) 현재 인쇄 작업이 취소되었습니다.

설명

이 메서드는 XPSDrv 필터에 의해 구현됩니다. 페이지 래스터화 작업 중에 XPS 래스터화 서비스는 주기적으로 이 메서드를 호출하여 작업을 계속할지 여부를 결정합니다.

페이지 래스터화 작업을 시작하기 위해 XPSDrv 필터는 IXpsRasterizer::RasterizeRect 메서드를 호출합니다. 이 호출을 사용하면 필터가 옵션으로 IXpsRasterizerNotificationCallback 인터페이스 instance 대한 포인터를 제공할 수 있습니다. 제공된 경우 RasterizeRect는 RasterizeRect 호출을 처리하는 동안 이 인터페이스에서 Continue 메서드를 주기적으로 호출합니다. Continue가 성공 코드를 반환하는 경우 RasterizeRect는 래스터화 작업을 계속 진행합니다. Continue가 오류 코드를 반환하는 경우 RasterizeRect는 래스터화 작업을 중단하고 즉시 반환합니다.

사용자가 인쇄 작업을 취소하거나 인쇄 작업을 처리하는 동안 오류가 발생하는 경우 파이프라인 관리자는 XPSDrv 필터의 IPrintPipelineFilter::ShutdownOperation 메서드를 호출하여 필터를 종료합니다. 일반적으로 필터는 Continue 메서드를 구현하고 RasterizeRect에 IXpsRasterizerNotificationCallback 포인터를 제공하는 경우 더 적시에 종료를 완료할 수 있습니다.

Continue 메서드의 구현 예제는 WDK의 XpsRasFilter 샘플을 참조하세요. 이 샘플은 WDK 설치의 Src\Print\Xpsrasfilter 폴더에 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 이상 버전의 Windows 운영 체제에서 지원됩니다.
대상 플랫폼 데스크톱
머리글 xpsrassvc.h

추가 정보

IPrintPipelineFilter::ShutdownOperation

IXpsRasterizer::RasterizeRect

IXpsRasterizerNotificationCallback