Метод IPrintOemUni::TTYGetInfo (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemUni::TTYGetInfo позволяет подключаемому модулем отрисовки предоставлять Unidrv сведения, относящиеся к принтерам только для текста.

Синтаксис

HRESULT TTYGetInfo(
  PDEVOBJ pdevobj,
  DWORD   dwInfoIndex,
  PVOID   pOutputBuf,
  DWORD   dwSize,
  DWORD   *pcbcNeeded
);

Параметры

pdevobj

Указатель на структуру DEVOBJ вызываемого абонента.

dwInfoIndex

Вызываемая константа, определяющая тип запрашиваемой информации. Определены следующие константы:

OEMTTY_INFO_CODEPAGE

Параметр pOutputBu f указывает на DWORD, в котором метод должен возвращать номер используемой кодовой страницы.

OEMTTY_INFO_MARGINS

Параметр pOutputBu f указывает на структуру RECT, в которой метод должен возвращать ширину поля страницы в десятых миллиметрах (например, 20 представляет 2 мм). Если вся страница печатается, все значения полей должны иметь значение 0.

OEMTTY_INFO_NUM_UFMS

Параметр pOutputBuf указывает на DWORD, в котором метод должен возвращать количество идентификаторов ресурсов для шрифтов 10, 12 и 17 CPI. Чтобы получить эти идентификаторы ресурсов, выполните запрос с помощью OEMTTY_INFO_UFM_IDS.

OEMTTY_INFO_UFM_IDS

Параметр pOutputBuf указывает на массив DWORD достаточного размера для хранения количества идентификаторов ресурсов UFM для шрифтов 10, 12 и 17 CPI. (Это число получается с помощью OEMTTY_INFO_NUM_UFMS в запросе.) Метод должен возвращать идентификаторы ресурсов UFMs для 10 12 и 17 шрифтов CPI.

pOutputBuf

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

dwSize

Указанный вызывающим объектом размер в байтах буфера, на который указывает pOutputBuf.

pcbcNeeded

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

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

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

Возвращаемый код	Описание
S_OK	Операция завершилась успешно.
E_FAIL	Сбой операции.
E_NOTIMPL	Метод не реализован.

Замечания

Метод IPrintOemUni::TTYGetInfo необязателен. Если подключаемый модуль отрисовки реализует этот метод, подключаемый модуль IPrintOemUni::GetImplementedMethod должен возвращать S_OK при получении "TTYGetInfo" в качестве входных данных.

Требования

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

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