IPrintTicketProvider::ConvertDevModeToPrintTicket 方法 (prdrvcom.h)

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

语法

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

参数

[in] cbDevmode

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

[in] pDevmode

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

[in] pPrintTicket

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

返回值

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

注解

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

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

要求

   
标头 prdrvcom.h (包括 Prdrvcom.h)

另请参阅

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode