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

IPrintOemUIMXDC::AdjustDPIメソッドを使用すると、XPS フィルター パイプライン ドライバーで UnidrvUI.dll または PS5UI.dll を使用して、イメージ解像度の構成をサポートできます。

構文

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

パラメーター

hPrinter

現在クエリを実行しているプリンターへのハンドル。

cbDevMode

追加されたデータを含む DEVMODE 構造体のサイズ。

pDevMode

現在のデバイス設定を含む DEVMODE 構造体へのポインター。

cbOEMDM

DEVMODE 構造体のベンダー指定セクションのバイト数。

pOEMDM

pDevMode が指す DEVMODE 構造体のベンダー部分に含まれるデータへのポインター。

pDPI

現在の解像度へのポインター (1 インチあたりのドット数 (DPI) で、正方形のピクセルを想定しています。 このパラメーターが構成されている場合、その戻り値は正の整数である必要があります。

戻り値

AdjustDPI は、メソッドが成功した場合にS_OKを返します。 それ以外の場合、このメソッドは、プラグインが メソッドをサポートしていない場合はE_NOTIMPLを返し、プラグインが操作を完了できない場合は適切なエラー値を返す必要があります。 詳細については、「解説」を参照してください。

注釈

pDPI パラメーターは IN OUT です。 この関数の他のすべてのパラメーターは入力のみです。

プラグインが操作を完了できない場合は、適切なエラー HRESULT が返され、現在の印刷ジョブが失敗します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Unidrvui.dll および再頒布可能な Ps5ui.dll で使用できます。 XPS Essentials Pack をインストールしている場合、このメソッドは Microsoft Windows XP の XPSDrv ドライバーでも使用できます。
対象プラットフォーム	デスクトップ
Header	prcomoem.h (Prcomoem.h を含む)