IPrintOemUIMXDC::AdjustImageCompression メソッド (prcomoem.h)

  • [アーティクル]

IPrintOemUIMXDC::AdjustImageCompressionメソッドを使用すると、XPS フィルター パイプライン ドライバーは、JPEG または PNG イメージの圧縮レベルの構成をサポートするために UnidrvUI.dll または PS5UI.dll を使用できます。

構文

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 ドライバーでも使用できます。
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)