Метод IPrintOemPS::GetInfo (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemPS::GetInfo модуля отрисовки возвращает идентификационные сведения.

Синтаксис

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Параметры

dwMode

Содержит одну из указанных ниже целочисленных констант вызывающего объекта.

OEMGI_GETPUBLISHERINFO

Метод должен указать, будет ли подключаемый модуль отрисовки использовать режим публикации. Параметр pBuffer указывает на структуру PUBLISHERINFO, которая будет заполнена методом. Дополнительные сведения см. в следующем разделе "Примечания".

OEMGI_GETREQUESTEDHELPERINTERFACES

Метод должен записать значение битового флага OEMPUBLISH_IPRINTCOREHELPER в буфер pBuffer, если метод IPrintOemPS::P ublishDriverInterface должен вызываться с параметром pIUnknown, указывающий на объект, реализующий интерфейс IPrintCoreHelperPS.

OEMGI_GETSIGNATURE

Метод должен возвращать уникальную сигнатуру идентификации четырехбайтов. Подключаемый модуль также должен поместить эту подпись в структуры OPTITEM, как описано в описании OEMCUIPPARAM. элемент структуры pOEMOptItems.

OEMGI_GETVERSION

Метод должен вернуть номер версии подключаемого модуля пользовательского интерфейса в виде DWORD. Формат версии определяется разработчиком.

pBuffer

Вызывающий указатель на память, выделенную для получения сведений, указанных dwMode.

cbSize

Указанный вызывающим размер буфера, на который указывает pBuffer.

pcbNeeded

Вызывающий указатель на расположение для получения количества байтов, записанных в буфер, на который указывает pBuffer.

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

Метод должен возвращать одно из следующих значений.

Возвращаемый код	Описание
S_OK	Операция завершилась успешно.
E_FAIL	Сбой операции
E_NOTIMPL	Метод не реализован.

Замечания

Подключаемые модули отрисовки для Pscript5 необходимы для реализации метода IPrintOemPS::GetInfo, который вызывается сразу после загрузки подключаемого модуля. Метод должен возвращать указанные сведения, записывая его в адрес, указанный pBuffer, и записывая размер в байтах возвращаемой информации в расположение, указанное pcbNeeded.

Если pBuffer значение NULL, метод должен просто использовать pcbNeed для возврата количества байтов, необходимых для хранения указанных сведений.

В режиме публикации все данные шрифта, которые нужно скачать, помещаются в заголовок задания. Каждый шрифт скачан только один раз и может использоваться для любой страницы, что позволяет заданию быть независимым от порядка страниц. Если dwMode OEMGI_GETPUBLISHERINFO, но подключаемый модуль не поддерживает режим публикации, IPrintOemPS::GetInfo должен возвращать E_NOTIMPL.

Дополнительные сведения о создании и установке подключаемых модулей отрисовки см. в настройке драйверов принтера Майкрософт.

Требования

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

См. также

IPrintOemPS

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo

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