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