IWICImageEncoder::WriteThumbnail-Methode (wincodec.h)
Codiert das angegebene Bild als Miniaturansicht für den angegebenen WIC-Bitmapencoder.
Syntax
HRESULT WriteThumbnail(
[in] ID2D1Image *pImage,
[in] IWICBitmapEncoder *pEncoder,
[in] const WICImageParameters *pImageParameters
);
Parameter
[in] pImage
Typ: ID2D1Image*
Das Direct2D-Bild, das codiert wird.
[in] pEncoder
Typ: IWICBitmapEncoder*
Der Encoder, auf dem die Miniaturansicht festgelegt ist.
[in] pImageParameters
Typ: const WICImageParameters*
Zusätzliche Parameter zum Steuern der Codierung.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie müssen das Image erstellen, das Sie auf demselben Gerät wie in IWICImagingFactory2::CreateImageEncoder übergeben. Wenn Sie keine zusätzlichen Parameter in der Variablen angeben, auf die pImageParameters verweist, verwendet der Encoder eine Reihe nützlicher Standardwerte. Informationen zu diesen Standardwerten finden Sie unter WICImageParameters.
Bevor Sie WriteThumbnail aufrufen, müssen Sie die IWICBitmapEncoder-Schnittstelle für den Encoder einrichten, für den Sie die Miniaturansicht festlegen möchten.
Wenn WriteThumbnail fehlschlägt, wird möglicherweise E_OUTOFMEMORY, D2DERR_WRONG_RESOURCE_DOMAIN oder andere Fehlercodes vom Encoder zurückgegeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wincodec.h |
| Bibliothek | Windowscodecs.lib |
| DLL | Windowscodecs.dll |