共用方式為


IWICImagingFactory::CreateDecoderFromFilename 方法 (wincodec.h)

根據指定的檔案,建立 IWICBitmapDecoder 類別的新實例。

語法

HRESULT CreateDecoderFromFilename(
  [in]          LPCWSTR           wzFilename,
  [in]          const GUID        *pguidVendor,
  [in]          DWORD             dwDesiredAccess,
  [in]          WICDecodeOptions  metadataOptions,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

參數

[in] wzFilename

類型: LPCWSTR

Null 終止字串的指標,指定要建立或開啟之對象的名稱。

[in] pguidVendor

類型: const GUID*

慣用譯碼器廠商的 GUID。 如果沒有慣用的廠商,請使用 NULL

[in] dwDesiredAccess

類型: DWORD

物件的存取權,可以是讀取、寫入或兩者。

意義
GENERIC_READ
讀取存取權。
GENERIC_WRITE
寫入存取權。
 

如需詳細資訊,請參閱 一般訪問許可權

[in] metadataOptions

類型: WICDecodeOptions

建立譯碼器時要使用的 WICDecodeOptions

[out, retval] ppIDecoder

類型: IWICBitmapDecoder**

接收新 IWICBitmapDecoder 指標的指標。

傳回值

類型: HRESULT

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

規格需求

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