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

Статья
02/07/2025

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

Синтаксис

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	Метод не реализован.

Замечания

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

Если pFeatureKeyword является строкой, он должен представлять аргумент ключевого слова для записи *OpenUI в PPD-файле Pscript5 мини-driver.
Метод должен возвращать одну или несколько строк, завершаемых null, в буфере, на которые указывает pOutput. Каждая строка должна представлять имя выбранного в данный момент параметра. Число строк должно возвращаться в pdwOptionsReturned.
Если pFeatureKeyword является константой, она должна быть одной из OEMGDS_-префиксированных констант, определенных в printoem.h. Метод должен вернуть значение, указанное указанной константой, поместив его в буфер, на который указывает pOutput. Значение, возвращаемое в pdwOptionsReturned, должно иметь значение 1.

Требования

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

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