共用方式為

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 Document Converter (MXDC) 所產生的 JPEG 和 PNG 影像。 此方法IPrintOemUIMXDC::AdjustImageCompression不會影響應用程式透過 GDI JPEG/PNG 映像傳遞機制直接傳送至 GDI 的 JPEG 和 PNG 映射， (BMF_JPEG，BMF_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)