Метод IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket (prcomoem.h)

Метод IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket преобразует структуру DEVMODEW в билет печати.

Синтаксис

HRESULT ConvertDevModeToPrintTicket(
  [in]      ULONG            cbDevmode,
  [in]      PDEVMODE         pDevmode,
  [in]      ULONG            cbDrvPrivateSize,
  [in]      PVOID            pPrivateDevmode,
  [in, out] IXMLDOMDocument2 *pPrintTicket
);

Параметры

[in] cbDevmode

Размер входной структуры DEVMODEW (в байтах). Размер включает как общедоступную, так и частную части этой структуры.

[in] pDevmode

Указатель на входную структуру DEVMODEW.

[in] cbDrvPrivateSize

Размер частной структуры DEVMODEW подключаемого модуля (в байтах).

[in] pPrivateDevmode

Указатель на частную структуру DEVMODEW подключаемого модуля.

[in, out] pPrintTicket

Указатель на частично завершенный билет печати. При возврате IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket должны быть заполнены все записи в билете печати.

Возвращаемое значение

IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket должен возвращать S_OK если операция выполнена успешно. В противном случае этот метод должен возвращать стандартный код ошибки COM.

Комментарии

Основной драйвер вызывает метод IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket с входным билетом печати, заполненным функциями public и Unidrv-private или Pscript5-private. Подключаемый модуль бесплатно устанавливает параметры DEVMODEW в общедоступной части или в частной части подключаемого модуля на основе параметров входного билета печати. В дополнение к настройке новых элементов DEVMODEW подключаемый модуль может изменять существующие параметры в общедоступной части структуры DEVMODEW.

Поля структуры DEVMODEW, которые коррелируют с частью структуры DEVMODEW, представляющая интерес для клиента, уже были заполнены до вызова IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket , включая общедоступную часть структуры DEVMODEW и исключая частные значения в общедоступной части структуры DEVMODEW.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть prcomoem.h (включая Prcomoem.h)

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

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode