Метод IPrintTicketProvider::ConvertPrintTicketToDevMode (prdrvcom.h)

Статья
08/07/2023

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

Синтаксис

HRESULT ConvertPrintTicketToDevMode(
  [in]  IN IXMLDOMDocument2 *pPrintTicket,
  [in]  IN ULONG            cbDevmodeIn,
  [in]  IN PDEVMODE         pDevmodeIn,
  [out] OUT ULONG           *pcbDevmodeOut,
  [out] OUT PDEVMODE        *ppDevmodeOut
);

Параметры

[in] pPrintTicket

Указатель на входной билет печати. IPrintTicketProvider::ConvertPrintTicketToDevMode преобразует параметры входного билета печати в поля в структуре DEVMODEW .

[in] cbDevmodeIn

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

[in] pDevmodeIn

Указатель на входную структуру DEVMODEW , которая содержит параметры по умолчанию. Структура DEVMODEW может быть структурой DEVMODEW по умолчанию для очереди печати или структурой DEVMODEW по умолчанию для пользователя. Так как этот параметр может представлять структуру DEVMODEW по умолчанию для пользователя, поставщик подключаемых модулей OEM должен проверить данные в этой структуре. Пользовательская структура DEVMODEW по умолчанию может быть недопустимой для конкретного драйвера, например при изменении или обновлении драйвера очереди печати.

[out] pcbDevmodeOut

Указатель на переменную, содержащую размер в байтах выходной структуры DEVMODEW .

[out] ppDevmodeOut

Указатель на переменную, содержащую адрес выходной структуры DEVMODEW . При успешном возвращении IPrintTicketProvider::ConvertPrintTicketToDevMode элементы выходной структуры DEVMODEW будут сброшены, чтобы отразить параметры в билете печати. Дополнительные сведения см. в разделе "Примечания".

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

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

Основной драйвер вызывает метод IPrintTicketProvider::ConvertPrintTicketToDevMode , прежде чем выполнить часть преобразования билета печати в структуру DEVMODEW . В вызове этого метода основной драйвер передает входной билет печати, который полностью заполнен, и структуру DEVMODEW со значениями по умолчанию. При преобразовании подключаемый модуль должен отменить все изменения, внесенные в билет печати во время предыдущего преобразования из структуры DEVMODEW в билет печати. Если во время этого предыдущего преобразования подключаемый модуль переместил функцию из частного пространства имен в общедоступное пространство имен, подключаемый модуль должен восстановить функцию в закрытом пространстве имен в формате, подходящем для основного драйвера, то есть в формате, в котором основной драйвер ранее разместил функцию в билете печати, предоставленном подключаемому модулем в IPrintOemPrintTicketProvider: Метод ConvertDevModeToPrintTicket . Это восстановление необходимо для того, чтобы основной драйвер смог распознать функцию в билете печати и отразить ее параметры в частной части структуры DEVMODEW основного драйвера, в то время как основной драйвер выполняет свою часть преобразования билета на печать в DEVMODEW .

Прежде чем система преобразует билет печати обратно в структуру DEVMODEW , она сначала загружает devmodew по умолчанию. Затем система вызывает метод IPrintTicketProvider::BindPrinter поставщика. Затем этот метод должен считывать все поддерживаемые параметры из билета печати и помещать их в структуру DEVMODEW . Обратите внимание, что не все функции обязательно будут представлены, и часто имеющиеся экземпляры Option могут содержать не все экземпляры оцененного свойства, которые обычно заполняет поставщик. Если поставщик вносит какие-либо изменения в параметры, которые были заполнены системой во время преобразования из билета печати в DEVMODEW, поставщик должен выполнить обратное изменение в этом методе. После возврата поставщика система перезаписывает все общедоступные параметры DEVMODEW , представленные в билете печати, но не отключенные поставщиком явным образом.

Требования

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

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

IPrintTicketProvider

IPrintTicketProvider::ConvertDevModeToPrintTicket

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