IWICBitmapCodecInfo::GetFileExtensions 方法 (wincodec.h)
擷取與編解碼器相關聯的擴展名逗號分隔清單。
語法
HRESULT GetFileExtensions(
[in] UINT cchFileExtensions,
[in, out] WCHAR *wzFileExtensions,
[in, out] UINT *pcchActual
);
參數
[in] cchFileExtensions
類型: UINT
擴展名緩衝區的大小。 在第一次呼叫時使用 0
來判斷所需的緩衝區大小。
[in, out] wzFileExtensions
類型: WCHAR*
接收與編解碼器相關聯的擴展名逗號分隔清單。 在第一次呼叫時使用 NULL
來判斷所需的緩衝區大小。
[in, out] pcchActual
類型: UINT*
擷取與編解碼器相關聯的所有擴展名所需的實際緩衝區大小。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
影像編碼器的默認擴充功能是傳回延伸模組清單中的第一個專案。
這個方法的使用模式是兩個呼叫進程。
第一次呼叫會擷取擷取完整色彩管理版本號碼所需的緩衝區大小,方法是呼叫 cchFileExtensions 設為 0
,並將 wzFileExtensions 設定為 NULL
。
此呼叫會將 pcchActual 設定為所需的緩衝區大小。
一旦決定所需的緩衝區大小,第二個 GetFileExtensions 呼叫 會將 cchFileExtensions 設定為緩衝區大小, 而 wzFileExtensions 設定為適當大小的緩衝區將會擷取圖元格式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincodec.h |
程式庫 | Windowscodecs.lib |