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

指向 DEVMODE 结构的供应商部分(pDevMode 指向的数据)的指针。

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 (include Prcomoem.h)

另请参阅

IPrintOemUIMXDC

RECTL