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 イメージ パススルー メカニズム (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 を含む)