Метод IPrintCoreUI2::D rvGetDriverSetting (prcomoem.h)

Статья
02/26/2024

Метод IPrintCoreUI2::DrvGetDriverSetting предоставляется драйвером Pscript5 для Windows XP, чтобы подключаемые модули пользовательского интерфейса Pscript5 могли получать текущее состояние функций принтера и другие внутренние сведения.

Синтаксис

HRESULT DrvGetDriverSetting(
  PVOID  pci,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Параметры

pci

Поставляемый вызывающим объектом указатель на структуру OEMUIOBJ .

Feature

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

pOutput

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

cbSize

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

pcbNeeded

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

pdwOptionsReturned

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

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

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

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

Этот метод наследуется от интерфейса COM IPrintOemDriverUI и может вызываться только подключаемыми модулями пользовательского интерфейса Windows XP и более поздних версий Pscript5, которые не полностью заменяют стандартные страницы пользовательского интерфейса основного драйвера, и поддерживается во время функций IPrintOemUI::D ocumentPropertySheets и IPrintOemUI::D evicePropertySheets , а также процедур обратного вызова страниц свойств. Если этот метод поддерживается, он работает так же, как iPrintOemDriverUI::D rvGetDriverSetting. Если он не поддерживается, этот метод должен возвращать E_NOTIMPL.