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

Weitere Informationen

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters