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