Метод IPrintOemUI::QueryColorProfile (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemUI::QueryColorProfile позволяет подключаемым модулем пользовательского интерфейса указать профиль ICC, используемый для управления цветом.

Синтаксис

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

Параметры

hPrinter

Вызывающий дескриптор принтера.

poemuiobj

Указатель на OEMUIOBJ.

pPublicDM

Указатель на проверенную структуру DEVMODEW вызывающего абонента.

pOEMDM

Вызывающий указатель на частные члены структуры DEVMODEW в пользовательском интерфейсе.

ulQueryMode

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

Флаг	Определение
QCP_DEVICEPROFILE	Вызывающий объект запрашивает профиль устройства.
QCP_SOURCEPROFILE	Вызывающий объект запрашивает исходный профиль.

pvProfileData

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

pcbProfileData

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

pflProfileData

Один из указанных ниже битовых флагов, указывающий тип информации, возвращаемой методом.

Флаг	Определение
QCP_PROFILEDISK	Метод возвращает имя файла профиля ICC в буфере, на который указывает pvProfileData.
QCP_PROFILEMEMORY	Метод возвращает данные профиля в буфере, на который указывает pvProfileData.

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

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

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

Замечания

Метод IPrintOemUI::QueryColorProfile пользовательского интерфейса выполняет те же типы операций, что и функция DrvQueryColorProfile, экспортируемая библиотеками DLL интерфейса принтера в пользовательском режиме. Сведения о событиях принтера и их обработке см. в описании функции DrvQueryColorProfile.

Если вы предоставляете подключаемый модуль пользовательского интерфейса, функция драйвера принтера DrvQueryColorProfile вызывает метод IPrintOemUI::QueryColorProfile. Функция DrvQueryColorProfile выполняет собственную обработку указанного события, а затем вызывает метод IPrintOemUI::QueryColorProfile для обработки дополнительной обработки события.

Если методы IPrintOemUI::QueryColorProfile экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указываются подключаемые модули для установки.

Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в настройке драйверов принтера Майкрософт.

Требования

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

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