Метод 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 , которые отключены и не преобразованы, поставщик подключаемых модулей отвечает за заполнение соответствующих значений билета печати. Если snapshot DEVMODEW была отключена во время вызова IPrintTicketProvider::BindPrinter, представление преобразования должно предоставлять достаточно сведений для восстановления исходной структуры DEVMODEW из билета печати без потери информации.

DEVMODEW snapshot обеспечивает поддержку тонких различий в параметрах, предоставляемых в структуре DEVMODEW, для которых билет печати может не иметь представлений. Например, DEVMODEW может поддерживать размер бумаги LETTER, а билет печати — размер бумаги LETTERSMALL.

Требования

Требование	Значение
Заголовок	prdrvcom.h (включая Prdrvcom.h)

См. также раздел

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode