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

  • Last updated on