Метод IWICDevelopRaw::SetNamedWhitePoint (wincodec.h)

Задает именованную белую точку необработанного файла.

Синтаксис

HRESULT SetNamedWhitePoint(
  [in] WICNamedWhitePoint WhitePoint
);

Параметры

[in] WhitePoint

Тип: WICNamedWhitePoint

Побитовое сочетание значений перечисления.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если именованные белые точки не поддерживаются необработанным изображением или необработанный файл содержит именованные белые точки, которые не поддерживаются этим API, разработчик кодека по-прежнему должен пометить эту возможность как поддерживаемую.

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

Если необработанный файл содержит именованные белые точки, не поддерживаемые этим API, разработчик кодека должен поддерживать именованные белые точки в API.

Из-за других методов настройки точек белого цвета (например, SetWhitePointKelvin) разработчики кодеков должны соблюдать осторожность, чтобы обеспечить надлежащее взаимодействие. Например, если вызывающий объект задает через именованную белую точку, то разработчик кодека может захотеть отключить считывание соответствующей температуры Кельвина. В конкретных случаях, когда разработчик кодека хочет запретить данное действие из-за предыдущих вызовов, необходимо вернуть WINCODEC_ERR_WRONGSTATE .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h
Библиотека	Windowscodecs.lib
DLL	Windowscodecs.dll