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

Метод IPrintOemDriverUI::D rvUpdateUISetting (prcomoem.h)

  • Статья

Метод IPrintOemDriverUI::DrvUpdateUISetting предоставляется мини-драйверами Unidrv и Pscript5, чтобы подключаемые модули пользовательского интерфейса могли уведомлять драйвер об изменении параметра пользовательского интерфейса.

Синтаксис

HRESULT DrvUpdateUISetting(
  PVOID pci,
  PVOID pOptItem,
  DWORD dwPreviousSelection,
  DWORD dwMode
);

Параметры

pci

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

pOptItem

Поставляемый вызывающим элементом указатель на структуру OPTITEM , описывающую элемент параметра пользовательского интерфейса.

dwPreviousSelection

Не используется.

dwMode

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

Значение Определение
OEMCUIP_DOCPROP Предоставленный элемент параметра принадлежит странице Дополнительно на странице свойств документа.
OEMCUIP_PRNPROP Предоставленный элемент параметра принадлежит странице Параметры устройства на странице свойств принтера.
 

Дополнительные сведения см. в разделе "Примечания".

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

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

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

Комментарии

Если вы предоставляете подключаемый модуль пользовательского интерфейса, реализующий метод IPrintOemUI::D ocumentPropertySheets или IPrintOemUI::D evicePropertySheets , обычно также предоставляется _CPSUICALLBACK типизированной функции обратного вызова для обработки изменений пользователей. Эта функция обратного вызова должна вызываться IPrintOemDriverUI::DrvUpdateUISetting , чтобы сообщить драйверу об изменении значения, связанного с параметром пользовательского интерфейса, если значение хранится в структуре DEVMODEW драйвера (вместо частных членов DEVMODEW подключаемого модуля) или в разделах реестра.

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

Требования

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