Condividi tramite


Metodo IWICBitmapFrameEncode::SetThumbnail (wincodec.h)

Imposta l'anteprima dei fotogrammi se supportata dal codec.

Sintassi

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parametri

[in] pIThumbnail

Tipo: IWICBitmapSource*

Origine bitmap da usare come anteprima.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un valore di errore in caso contrario.

Restituisce WINCODEC_ERR_UNSUPPORTEDOPERATION se la funzionalità non è supportata dal codificatore.

Commenti

È consigliabile chiamare SetThumbnail prima di chiamare WritePixels o WriteSource. L'anteprima non verrà aggiunta al file codificato se SetThumbnail viene chiamato dopo una chiamata a WritePixels o WriteSource.

  • BMP, PNGL'impostazione delle anteprime non è supportata. Questa funzione restituirà WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • JPEGL'impostazione dell'anteprima è supportata. L'immagine di origine verrà codificata nuovamente come JPEG 8bpp o 24bpp e verrà scritta nel blocco di metadati APP1 di JPEG.
  • TIFF L'impostazione dell'anteprima è supportata. L'immagine di origine verrà codificata nuovamente come TIFF e verrà scritta nel blocco SubIFD del frame.
  • JPEG-XRL'impostazione dell'anteprima è supportata. L'immagine di origine verrà codificata nuovamente come frame aggiuntivo da 8bpp o 24bpp.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2, Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincodec.h
Libreria Windowscodecs.lib
DLL Windowscodecs.dll

Vedi anche

Informazioni concettuali

Panoramica della codifica

Come scrivere un codec WIC-Enabled

IWICBitmapFrameEncode