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 结构的指针。 在将参数传递到插件之前,由 UnidrvUI.dll 或 PS5UI.dll 使用相应 GPD 或 PPD 中的数据填充此参数。 然后,插件可以在返回之前更新此数据。

返回值

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