Метод IWICImageEncoder::WriteThumbnail (wincodec.h)

Кодирует заданное изображение в качестве эскиза в заданный кодировщик точечного изображения WIC.

Синтаксис

HRESULT WriteThumbnail(
  [in] ID2D1Image               *pImage,
  [in] IWICBitmapEncoder        *pEncoder,
  [in] const WICImageParameters *pImageParameters
);

Параметры

[in] pImage

Тип: ID2D1Image*

Закодированное изображение Direct2D.

[in] pEncoder

Тип: IWICBitmapEncoder*

Кодировщик, для которого задан эскиз.

[in] pImageParameters

Тип: const WICImageParameters*

Дополнительные параметры для управления кодировкой.

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

Тип: HRESULT

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

Комментарии

Необходимо создать образ, который передается на том же устройстве, что и в IWICImagingFactory2::CreateImageEncoder. Если не указать дополнительные параметры в переменной, на которую указывает pImageParameters , кодировщик использует набор полезных значений по умолчанию. Сведения об этих значениях по умолчанию см. в разделе WICImageParameters.

Перед вызовом WriteThumbnail необходимо настроить интерфейс IWICBitmapEncoder для кодировщика, для которого требуется задать эскиз.

Если WriteThumbnail завершается сбоем, он может возвращать E_OUTOFMEMORY, D2DERR_WRONG_RESOURCE_DOMAIN или другие коды ошибок из кодировщика.

Требования

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

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters