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

Codifica la imagen especificada como miniatura en el codificador de mapa de bits WIC determinado.

Sintaxis

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

Parámetros

[in] pImage

Tipo: ID2D1Image*

Imagen de Direct2D que se codificará.

[in] pEncoder

Tipo: IWICBitmapEncoder*

Codificador en el que se establece la miniatura.

[in] pImageParameters

Tipo: const WICImageParameters*

Parámetros adicionales para controlar la codificación.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Debe crear la imagen que pase en el mismo dispositivo que en IWICImagingFactory2::CreateImageEncoder. Si no especifica parámetros adicionales en la variable a la que apunta pImageParameters , el codificador usa un conjunto de valores predeterminados útiles. Para obtener información sobre estos valores predeterminados, consulta WICImageParameters.

Antes de llamar a WriteThumbnail, debe configurar la interfaz IWICBitmapEncoder para el codificador en el que desea establecer la miniatura.

Si se produce un error en WriteThumbnail , puede devolver E_OUTOFMEMORY, D2DERR_WRONG_RESOURCE_DOMAIN u otros códigos de error del codificador.

Requisitos

Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll

Consulte también

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters