Freigeben über


IWICImagingFactory::CreateDecoder-Methode (wincodec.h)

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