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

另请参阅

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode