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

Статья
02/07/2025

Метод 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 с входным билетом печати, заполненным общедоступными и частными функциями Unidrv или Pscript5-private. Подключаемый модуль бесплатно устанавливает параметры DEVMODEW в общедоступной части или в частной части подключаемого модуля на основе параметров входного билета печати. В дополнение к настройке новых элементов DEVMODEW подключаемый модуль может изменять существующие параметры в общедоступной части структуры DEVMODEW.

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

См. также

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode

Поделиться через