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

Статья
08/07/2023

Метод подключаемого модуля отрисовки 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, метод должен просто использовать pcbNeeded для возврата количества байтов, необходимых для хранения указанных сведений.

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

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

Требования

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

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

IPrintOemPS

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo

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