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