IPrintTicketProvider2::ConvertDevModeToPrintTicket 方法 (prdrvcom.h)

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

语法

HRESULT ConvertDevModeToPrintTicket(
  [in] IN ULONG            cbDevmode,
  [in] IN PDEVMODE         pDevmode,
  [in] IN IXMLDOMDocument2 *pPrintTicket
);

参数

[in] cbDevmode

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

[in] pDevmode

指向输入 DEVMODEW 结构的指针,包括其公共部分和专用部分。

[in] pPrintTicket

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

返回值

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

注解

当打印系统将 DEVMODEW 结构的内容转换为打印票证时,它将转换所有公共 DEVMODEW 字段,但插件提供程序已指示应禁用的字段除外。 对于这些已禁用且未转换的 DEVMODEW 字段,插件提供程序负责填充相应的打印票证值。 如果在调用 IPrintTicketProvider2::BindPrinter 期间禁用了 DEVMODEW 快照,则转换中的表示形式必须提供足够的信息,以便从打印票证重建原始 DEVMODEW 结构,而不会丢失信息。

DEVMODEW 快照支持在 DEVMODEW 结构中提供的选项(打印票证可能没有表示形式)中的细微差别。 例如, DEVMODEW 可能支持 LETTER 纸张大小,而打印票证支持 LETTERMALL 纸张大小。

要求

要求
Header prdrvcom.h (包括 Prdrvcom.h)

另请参阅

IPrintTicketProvider2

IPrintTicketProvider2::ConvertPrintTicketToDevMode