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

Метод 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 (включая Prcomoem.h)