IWICImagingFactory：：CreateEncoder 方法 (wincodec.h)

  • 發行項

建立 IWICBitmapEncoder 類別的新實例。

語法

HRESULT CreateEncoder(
  [in]           REFGUID           guidContainerFormat,
  [in, optional] const GUID        *pguidVendor,
  [out, retval]  IWICBitmapEncoder **ppIEncoder
);

參數

[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, optional] pguidVendor

類型： const GUID*

慣用編碼器廠商的 GUID。

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

[out, retval] ppIEncoder

類型： IWICBitmapEncoder**

接收新 IWICBitmapEncoder 指標的指標。

傳回值

類型： HRESULT

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

備註

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

規格需求

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

另請參閱

IWICImagingFactory

WIC GUID 和 CLSID