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) |