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

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

  • Статья

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

Синтаксис

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

Параметры

pdriverobj

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

Feature

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

pOutput

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

cbSize

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

pcbNeeded

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

pdwOptionsReturned

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

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

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

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

Комментарии

При вызове IPrintOemDriverUni::DrvGetDriverSetting метода для параметра pFeatureKeyword можно указать строковый указатель или константное значение.

  • Если pFeatureKeyword является строкой, она должна представлять имя компонента, указанное в файле GPD мини-драйвера Unidrv .

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

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

Требования

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