Compartilhar via


Método IWICImageEncoder::WriteThumbnail (wincodec.h)

Codifica a imagem fornecida como a miniatura para o codificador de bitmap WIC especificado.

Sintaxe

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

Parâmetros

[in] pImage

Tipo: ID2D1Imagem*

A imagem direct2D que será codificada.

[in] pEncoder

Tipo: IWICBitmapEncoder*

O codificador no qual a miniatura está definida.

[in] pImageParameters

Tipo: const WICImageParameters*

Parâmetros adicionais para controlar a codificação.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Você deve criar a imagem que você passa no mesmo dispositivo que em IWICImagingFactory2::CreateImageEncoder. Se você não especificar parâmetros adicionais na variável para a qual pImageParameters aponta, o codificador usará um conjunto de padrões úteis. Para obter informações sobre esses padrões, consulte WICImageParameters.

Antes de chamar WriteThumbnail, você deve configurar a interface IWICBitmapEncoder para o codificador no qual deseja definir a miniatura.

Se WriteThumbnail falhar, ele poderá retornar E_OUTOFMEMORY, D2DERR_WRONG_RESOURCE_DOMAIN ou outros códigos de erro do codificador.

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincodec.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll

Confira também

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters