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

Статья
02/26/2024

Метод подключаемого модуля отрисовки IPrintOemUni::GetInfo возвращает идентификационную информацию.

Синтаксис

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

Параметры

dwMode

Содержит одну из следующих целочисленных констант, предоставляемых вызывающим.

OEMGI_GETREQUESTEDHELPERINTERFACES

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

OEMGI_GETSIGNATURE

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

OEMGI_GETVERSION

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

pBuffer

Предоставленный вызывающим объектом указатель на память, выделенную для получения сведений, указанных в dwInfo.

cbSize

Предоставленный вызывающим объектом размер буфера, на который указывает pBuffer.

pcbNeeded

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

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

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

Код возврата	Описание
S_OK	Операция успешно выполнена.
E_FAIL	Операция не удалась.

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

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

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

Требования

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

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

IPrintOemPS::GetInfo

IPrintOemUI::GetInfo

IPrintOemUni

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