IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket 方法 (prcomoem.h)

IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket 方法将 DEVMODEW 结构转换为打印票证。

语法

HRESULT ConvertDevModeToPrintTicket(
  [in]      ULONG            cbDevmode,
  [in]      PDEVMODE         pDevmode,
  [in]      ULONG            cbDrvPrivateSize,
  [in]      PVOID            pPrivateDevmode,
  [in, out] IXMLDOMDocument2 *pPrintTicket
);

参数

[in] cbDevmode

输入 DEVMODEW 结构的大小(以字节为单位)。 该大小包括此结构的公共部分和专用部分。

[in] pDevmode

指向输入 DEVMODEW 结构的指针。

[in] cbDrvPrivateSize

插件的专用 DEVMODEW 结构的大小(以字节为单位)。

[in] pPrivateDevmode

指向插件的专用 DEVMODEW 结构的指针。

[in, out] pPrintTicket

指向部分完成的打印票证的指针。 当 IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket 返回时,打印票证中的所有条目都应填写。

返回值

IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket 如果作成功,应返回S_OK。 否则,此方法应返回标准 COM 错误代码。

言论

核心驱动程序调用 IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket 方法,其输入打印票证填充了公共和 Unidrv-private 或 Pscript5-private 功能。 插件可以自由设置 DEVMODEW 公共部件或插件专用部件中的设置,具体取决于输入打印票证中的设置。 除了设置新的 DEVMODEW 项之外,插件还可以修改 DEVMODEW 结构的公共部分中的现有设置。

在调用 IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket(包括 DEVMODEW 结构的公共部分和排除 DEVMODEW 结构的公共部分)之前,已填充与客户端感兴趣的 DEVMODEW 结构的一部分相关的 DEVMODEW 结构字段。

要求

要求 价值
目标平台 桌面
标头 prcomoem.h (include Prcomoem.h)

另请参阅

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode