Метод IWICBitmapFrameEncode::SetPixelFormat (wincodec.h)

  • Статья

Запрашивает, чтобы кодировщик использовал указанный формат пикселей.

Синтаксис

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

Параметры

[in, out] pPixelFormat

Тип: WICPixelFormatGUID*

На входных данных — guid запрошенного формата пикселей. В выходных данных — guid ближайшего формата пикселей, поддерживаемый кодировщиком; этот формат может отличаться от запрошенного формата. Список GUID формата пикселей см. в разделе Собственные форматы пикселей.

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

Тип: HRESULT

Возможные возвращаемые значения включают следующие.

Код возврата Описание
S_OK
 Успешно.
WINCODEC_ERR_WRONGSTATE
 Метод IWICBitmapFrameEncode::Initialize не был вызван.

Комментарии

Кодировщик может не поддерживать запрошенный формат пикселей. В противном случае SetPixelFormat возвращает ближайшее совпадение в блоке памяти, на который указывает pPixelFormat . Если возвращаемый формат пикселей не соответствует запрошенным, необходимо использовать объект IWICFormatConverter для преобразования данных в пикселях.

Требования

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

См. также раздел

IWICBitmapFrameEncode

Собственные форматы пикселей