共用方式為


IWICImagingFactory::CreateDecoder 方法 (wincodec.h)

建立 IWICBitmapDecoder 的新實例。

語法

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

參數

[in] guidContainerFormat

類型: REFGUID

所需容器格式的 GUID。

意義
GUID_ContainerFormatBmp
BMP 容器格式 GUID。
GUID_ContainerFormatPng
PNG 容器格式 GUID。
GUID_ContainerFormatIco
ICO 容器格式 GUID。
GUID_ContainerFormatJpeg
JPEG 容器格式 GUID。
GUID_ContainerFormatTiff
TIFF 容器格式 GUID。
GUID_ContainerFormatGif
GIF 容器格式 GUID。
GUID_ContainerFormatWmp
HD Photo 容器格式 GUID。

[in] pguidVendor

類型: const GUID*

慣用編碼器廠商的 GUID。

意義
NULL
沒有慣用的編解碼器廠商。
GUID_VendorMicrosoft
偏好使用 Microsoft 編碼器。
GUID_VendorMicrosoftBuiltIn
偏好使用原生 Microsoft 編碼器。

[out, retval] ppIDecoder

類型: IWICBitmapDecoder**

接收新 IWICBitmapDecoder 指標的指標。 您稍後必須使用 Initialize 方法,在數據流上初始化這個 IWICBitmapDecoder

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

根據已安裝的 WIC 編碼器而定,其他值可能同時適用於 guidContainerFormatpguidVendor 。 列出的值是操作系統原生支援的值。

規格需求

需求
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib
Dll Windowscodecs.dll

另請參閱

IWICImagingFactory

WIC GUID 和 CLSID