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

  • Artículo

Establece la miniatura del marco si es compatible con el códec.

Sintaxis

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parámetros

[in] pIThumbnail

Tipo: IWICBitmapSource*

Origen del mapa de bits que se va a usar como miniatura.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error.

Devuelve WINCODEC_ERR_UNSUPPORTEDOPERATION si el codificador no admite la característica.

Comentarios

Se recomienda llamar a SetThumbnail antes de llamar a WritePixels o WriteSource. La miniatura no se agregará al archivo codificado si se llama a SetThumbnail después de una llamada a WritePixels o WriteSource.

  • BMP, PNGNo se admite la configuración de miniaturas. Esta función devolverá WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • JPEGSe admite la configuración de la miniatura. La imagen de origen se volverá a codificar como un JPEG de 8bpp o 24bpp y se escribirá en el bloque de metadatos APP1 de JPEG.
  • TIFF Se admite la configuración de la miniatura. La imagen de origen se volverá a codificar como un TIFF y se escribirá en el bloque SubIFD del marco.
  • JPEG-XRSe admite la configuración de la miniatura. La imagen de origen se volverá a codificar como un marco adicional de 8bpp o 24bpp.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincodec.h
Library Windowscodecs.lib
Archivo DLL Windowscodecs.dll

Consulte también

Conceptual

Introducción a la codificación

Cómo escribir un CÓDEC de WIC-Enabled

IWICBitmapFrameEncode