Compartilhar via


Método IWICBitmapFrameEncode::SetThumbnail (wincodec.h)

Define a miniatura do quadro se houver suporte do codec.

Sintaxe

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parâmetros

[in] pIThumbnail

Tipo: IWICBitmapSource*

A fonte de bitmap a ser usada como miniatura.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro.

Retorna WINCODEC_ERR_UNSUPPORTEDOPERATION se o recurso não tiver suporte do codificador.

Comentários

Recomendamos que você chame SetThumbnail antes de chamar WritePixels ou WriteSource. A miniatura não será adicionada ao arquivo codificado se SetThumbnail for chamado após uma chamada para WritePixels ou WriteSource.

  • BMP, PNGNão há suporte para a configuração de miniaturas. Essa função retornará WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • JPEGHá suporte para a configuração da miniatura. A imagem de origem será recodificada como um JPEG de 8bpp ou 24bpp e será gravada no bloco de metadados APP1 do JPEG.
  • TIFF Há suporte para a configuração da miniatura. A imagem de origem será recodificada como um TIFF e será gravada no bloco SubIFD do quadro.
  • JPEG-XRHá suporte para a configuração da miniatura. A imagem de origem será recodificada como um quadro adicional de 8bpp ou 24bpp.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincodec.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll

Confira também

Conceitual

Visão geral da codificação

Como escrever um CODEC WIC-Enabled

Iwicbitmapframeencode