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

こちらもご覧ください

IPrintOemUIMXDC

RECTL