Метод IPrintOemUI::D evicePropertySheets (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemUI::DevicePropertySheets позволяет подключаемым модулем пользовательского интерфейса добавлять новую страницу на лист свойств принтера устройства принтера.

Синтаксис

HRESULT DevicePropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Параметры

pPSUIInfo

Указатель на PROPSHEETUI_INFO структуру, предоставляемую вызывающим абонентом.

lParam

Вызываемое значение, которое зависит от значения причины в pPSUIInfo->причина. Значение причины может быть одним из следующих констант, определенных в compstui.h. Дополнительные сведения об этих константах см. в разделе "Примечания" и описание параметра lParam в типе функции PFNPROPSHEETUI.

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

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

Возвращаемое значение зависит от содержимого элемента структуры PROPSHEETUI_INFO Reason. Дополнительные сведения см. в описании DrvDevicePropertySheets.

Замечания

Метод IPrintOemUI::DevicePropertySheets пользовательского интерфейса выполняет те же типы операций, что и функция DrvDevicePropertySheets, экспортируемая библиотеками DLL интерфейса принтера в пользовательском режиме. Обе функции имеют одинаковые входные параметры.

Если вы предоставляете подключаемый модуль пользовательского интерфейса, метод IPrintOemUI::DevicePropertySheets вызывается после вызова функции драйвера DrvDevicePropertySheets.

При вызове IPrintOemUI::DevicePropertySheets элемент lParamInit в структуре PROPSHEETUI_INFO содержит адрес структуры OEMUIPSPARAM.

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

Если методы IPrintOemUI::DevicePropertySheets экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указываются подключаемые модули для установки.

Если один подключаемый модуль пользовательского интерфейса поддерживает несколько моделей принтера, и если для некоторых из этих моделей будет отображаться только новая страница, метод IPrintOemUI::DevicePropertySheets должен просто предоставить возвращаемое значение успешного выполнения, не добавляя страницу, для моделей, не требующих страницы.

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