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

Статья
02/07/2025

Метод IPrintOemDriverUI::DrvGetDriverSetting предоставляется мини-drivers Unidrv и 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	Метод не реализован.

Замечания

При вызове метода IPrintOemDriverUI::DrvGetDriverSetting подключаемый модуль пользовательского интерфейса может указывать либо строковый указатель, либо константное значение для pFeatureKeyword.

Если pFeatureKeyword является строкой, она должна представлять одну из следующих строк:
- Имя функции, указанное в файле minidriver Unidrv GPD-файл или
- Аргумент ключевого слова для записи OpenUIOpenUI в PPD-файле Pscript5 мини-driver.
Метод возвращает одну или несколько строк, завершаемых значением NULL, в буфере, на которые указывает pOutput. Каждая строка представляет имя выбранного в данный момент параметра. Число строк возвращается в pdwOptionsReturned.
Если pFeatureKeyword является константой, она должна быть одной из OEMGDS_-префиксированных констант, определенных в printoem.h. Метод возвращает значение, указанное указанной константой, помещая его в буфер, на который указывает pOutput. Значение, возвращаемое в pdwOptionsReturned, всегда равно 1.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

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