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 |