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

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

  • Статья

Метод IPrintOemDriverUI::DrvGetDriverSetting предоставляется мини-драйверами 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 является строкой, она должна представлять одно из следующих значений:
    • Имя компонента, указанное в файле GPD мини-драйвера Unidrv , или
    • Аргумент ключевое слово записи *OpenUI в PPD-файле мини-драйвера Pscript5.

    Метод возвращает одну или несколько строк, завершаемых значением NULL, в буфере, на который указывает pOutput. Каждая строка представляет имя выбранного в данный момент параметра. Количество строк возвращается в pdwOptionsReturned.

  • Если pFeatureKeyword является константой, это должна быть одна из OEMGDS_ констант с префиксом, определенных в printoem.h. Метод возвращает значение, указанное указанной константой, помещая его в буфер, на который указывает pOutput. Значение, возвращаемое в pdwOptionsReturned , всегда равно 1.

Требования

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