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 映像傳遞機制直接傳送至 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 （include Prcomoem.h）