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 结构公共部分中的私有定义值。

要求

另请参阅

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider：：ConvertPrintTicketToDevMode