Partager via


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

Définit la miniature du cadre si elle est prise en charge par le codec.

Syntaxe

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Paramètres

[in] pIThumbnail

Type : IWICBitmapSource*

Source bitmap à utiliser comme miniature.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire.

Retourne WINCODEC_ERR_UNSUPPORTEDOPERATION si la fonctionnalité n’est pas prise en charge par l’encodeur.

Remarques

Nous vous recommandons d’appeler SetThumbnail avant d’appeler WritePixels ou WriteSource. La miniature n’est pas ajoutée au fichier encodé si SetThumbnail est appelé après un appel à WritePixels ou WriteSource.

  • BMP, PNGLa définition de miniatures n’est pas prise en charge. Cette fonction retourne WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • JPEGLa définition de la miniature est prise en charge. L’image source est réencodée au format JPEG 8bpp ou 24bpp et est écrite dans le bloc de métadonnées APP1 du JPEG.
  • TIFF La définition de la miniature est prise en charge. L’image source sera réencodée en tant que TIFF et écrite dans le bloc SubIFD de la trame.
  • JPEG-XRLa définition de la miniature est prise en charge. L’image source est réencodée en tant que frame supplémentaire de 8 ou 24 bpp.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2, Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincodec.h
Bibliothèque Windowscodecs.lib
DLL Windowscodecs.dll

Voir aussi

Conceptuel

Vue d’ensemble de l’encodage

Comment écrire un codec WIC-Enabled

IWICBitmapFrameEncode