IWICImagingFactory::CreateDecoder-Methode (wincodec.h)

Artikel
03/03/2024

Erstellt eine neue instance von IWICBitmapDecoder.

Syntax

HRESULT CreateDecoder(
  [in]          REFGUID           guidContainerFormat,
  [in]          const GUID        *pguidVendor,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

Parameter

[in] guidContainerFormat

Typ: REFGUID

Die GUID für das gewünschte Containerformat.

Wert	Bedeutung
GUID_ContainerFormatBmp	Die GUID im BMP-Containerformat.
GUID_ContainerFormatPng	Die GUID im PNG-Containerformat.
GUID_ContainerFormatIco	Die ICO-Containerformat-GUID.
GUID_ContainerFormatJpeg	Die GUID im JPEG-Containerformat.
GUID_ContainerFormatTiff	Die TIFF-Containerformat-GUID.
GUID_ContainerFormatGif	Die GIF-Containerformat-GUID.
GUID_ContainerFormatWmp	Die HD Photo-Containerformat-GUID.

[in] pguidVendor

Typ: const GUID*

Die GUID für den bevorzugten Encoderanbieter.

Wert	Bedeutung
NULL	Kein bevorzugter Codecanbieter.
GUID_VendorMicrosoft	Verwenden Sie lieber den Microsoft-Encoder.
GUID_VendorMicrosoftBuiltIn	Verwenden Sie lieber den nativen Microsoft-Encoder.

[out, retval] ppIDecoder

Typ: IWICBitmapDecoder**

Ein Zeiger, der einen Zeiger auf einen neuen IWICBitmapDecoder empfängt. Sie müssen diesen IWICBitmapDecoder später mithilfe der Initialize-Methode in einem Stream initialisieren.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Je nach installierten WIC-fähigen Encodern sind möglicherweise andere Werte für guidContainerFormat und pguidVendor verfügbar. Bei den aufgeführten Werten handelt es sich um Werte, die vom Betriebssystem nativ unterstützt werden.

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

Weitere Informationen

IWICImagingFactory

WIC-GUIDs und CLSIDs

Freigeben über