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