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


Метод IWICBitmapFrameDecode::GetColorContexts (wincodec.h)

Извлекает объект IWICColorContext , связанный с кадром изображения.

Синтаксис

HRESULT GetColorContexts(
  [in]      UINT             cCount,
  [in, out] IWICColorContext **ppIColorContexts,
  [out]     UINT             *pcActualCount
);

Параметры

[in] cCount

Тип: UINT

Количество извлекаемых контекстов цвета.

Это значение должно быть размером или меньше размера, доступного для ppIColorContexts.

[in, out] ppIColorContexts

Тип: IWICColorContext**

Указатель, получающий указатель на объекты IWICColorContext .

[out] pcActualCount

Тип: UINT*

Указатель, который получает количество контекстов цвета, содержащихся в кадре изображения.

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

Тип: HRESULT

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

Комментарии

Если для ppIColorContexts передается значение NULL, а для cCount — значение 0, этот метод возвращает общее количество контекстов цвета в изображении в pcActualCount.

Массив ppIColorContexts должен быть заполнен допустимыми данными: каждый IWICColorContext* в массиве должен быть создан с помощью IWICImagingFactory::CreateColorContext.

Требования

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