IWICBitmapFrameEncode::SetThumbnail-Methode (wincodec.h)

Legt die Frameminiaturansicht fest, wenn sie vom Codec unterstützt wird.

Syntax

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parameter

[in] pIThumbnail

Typ: IWICBitmapSource*

Die Bitmapquelle, die als Miniaturansicht verwendet werden soll.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück.

Gibt WINCODEC_ERR_UNSUPPORTEDOPERATION zurück, wenn das Feature vom Encoder nicht unterstützt wird.

Hinweise

Es wird empfohlen, SetThumbnail aufzurufen, bevor Sie WritePixels oder WriteSource aufrufen. Die Miniaturansicht wird der codierten Datei nicht hinzugefügt, wenn SetThumbnail nach einem Aufruf von WritePixels oder WriteSource aufgerufen wird.

  • BMP, PNGDas Festlegen von Miniaturansichten wird nicht unterstützt. Diese Funktion gibt WINCODEC_ERR_UNSUPPORTEDOPERATION zurück.
  • JPEGDas Festlegen der Miniaturansicht wird unterstützt. Das Quellbild wird entweder als 8bpp oder 24bpp JPEG neu codiert und in den APP1-Metadatenblock des JPEG geschrieben.
  • TIFF Das Festlegen der Miniaturansicht wird unterstützt. Das Quellbild wird als TIFF neu codiert und in den SubIFD-Block des Frames geschrieben.
  • JPEG-XRDas Festlegen der Miniaturansicht wird unterstützt. Das Quellbild wird als zusätzlicher 8bpp- oder 24bpp-Frame neu codiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll

Siehe auch

Konzept

Übersicht über die Codierung

Schreiben eines WIC-Enabled CODEC

IWICBitmapFrameEncode