Метод 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, которые отключены и не преобразованы, подключаемый модуль отвечает за заполнение соответствующих значений билета печати. Если моментальный снимок DEVMODEW был отключен во время вызова IPrintTicketProvider::BindPrinter, представление из преобразования должно предоставить достаточно сведений, чтобы восстановить исходную DEVMODEW структуру из билета печати без потери информации.
Моментальный снимок DEVMODEW позволяет поддерживать тонкие различия в параметрах, предоставляемых в структуре DEVMODEW, для которой билет печати может не иметь представления. Например, DEVMODEW может поддерживать размер бумаги LETTER, а билет печати поддерживает размер бумаги LETTERSMALL.
Требования
| Требование | Ценность |
|---|---|
| заголовка | prdrvcom.h (include Prdrvcom.h) |