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

IPrintOemUIMXDC::AdjustImageableArea メソッドを使用すると、XPS フィルター パイプライン ドライバーで UnidrvUI.dll または PS5UI.dll を使用して、回転の向きや方向など、印刷可能領域の構成をサポートできます。

構文

HRESULT AdjustImageableArea(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PRECTL         prclImageableArea
);

パラメーター

hPrinter

現在照会中のプリンターへのハンドル。

cbDevMode

追加されたデータを含む、DEVMODE 構造体のサイズ (バイト単位)。

pDevMode

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

cbOEMDM

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

pOEMDM

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

prclImageableArea

印刷可能領域を含む RECTL 構造体へのポインター。 このパラメーターは、パラメーターがプラグインに渡される前に、対応する GPD または PPD からのデータを UnidrvUI.dll または PS5UI.dll によって設定されます。 その後、プラグインは、戻る前にこのデータを更新できます。

戻り値

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

備考

prclImageableArea パラメーターは IN OUT です。 このメソッドの他のすべてのパラメーターは入力のみです。

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

必要条件

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

関連項目

IPrintOemUIMXDC の

RECTL の