다음을 통해 공유

IPrintOemUIMXDC::AdjustImageCompression 메서드(prcomoem.h)

  • 아티클

이 IPrintOemUIMXDC::AdjustImageCompression 메서드를 사용하면 XPS 필터 파이프라인 드라이버가 UnidrvUI.dll 또는 PS5UI.dll 사용하여 JPEG 또는 PNG 이미지에 대한 압축 수준 구성을 지원할 수 있습니다.

구문

HRESULT AdjustImageCompression(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PLONG          pCompressionMode
);

매개 변수

hPrinter

현재 쿼리 중인 프린터에 대한 핸들입니다.

cbDevMode

추가된 데이터를 포함하여 DEVMODE 구조체의 크기입니다.

pDevMode

현재 디바이스 설정을 포함하는 DEVMODE 구조체에 대한 포인터입니다.

cbOEMDM

DEVMODE 구조체의 공급업체 제공 섹션에 있는 바이트 수입니다.

pOEMDM

pDevMode가 가리키는 DEVMODE 구조체의 공급업체 부분에 포함된 데이터에 대한 포인터입니다.

pCompressionMode

현재 압축 수준에 대한 포인터입니다. pCompressionMode 는 Mxdc.h에 지정된 열거형 형식입니다.

반환 값

AdjustImageCompression 는 메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 플러그 인이 메서드를 지원하지 않는 경우 E_NOTIMPL 반환하거나 플러그 인이 작업을 완료할 수 없는 경우 적절한 오류 값을 반환해야 합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

설명

메서드는 IPrintOemUIMXDC::AdjustImageCompression Microsoft XPS MXDC(문서 변환기)에서 생성된 JPEG 및 PNG 이미지에 영향을 줍니다. 메서드는 IPrintOemUIMXDC::AdjustImageCompression GDI JPEG/PNG 이미지 통과 메커니즘(BMF_JPEG, BMF_PNG)을 통해 애플리케이션에서 GDI로 직접 전송되는 JPEG 및 PNG 이미지에 영향을 주지 않습니다.

UnidrvUI.dll 및 PS5UI.dll 핵심 드라이버는 이미지 압축 설정을 수정하지 않습니다. 그러나 플러그 인은 GDI 인쇄 경로에 의해 MXDC에 처음 제공된 값을 변경할 수 있습니다.

pCompressionMode 매개 변수에는 다음과 같은 미리 정의된 값 중 하나가 있습니다.

ENUM 형식 값 의미
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION 1 가장 낮은 품질 및 가장 작은 파일 크기
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION 2 중간 품질 및 중간 파일 크기
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION 3 고품질 및 대용량 파일 크기
MXDC_IMAGETYPE_PNG 4 최고 품질 및 가장 큰 파일 크기
 

pCompressionMode 매개 변수는 IN OUT입니다. 이 함수에 대한 다른 모든 매개 변수는 입력 전용입니다.

플러그 인이 작업을 완료할 수 없는 경우 적절한 오류 HRESULT를 반환해야 하므로 현재 인쇄 작업이 실패합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 재배포할 수 있는 Windows Vista 이상 버전의 Unidrvui.dll 및 Ps5ui.dll 사용할 수 있습니다. 이 방법은 XPS Essentials Pack을 설치한 경우 Microsoft Windows XP의 XPSDrv 드라이버에도 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 prcomoem.h(Prcomoem.h 포함)