IWICBitmapCodecInfo::GetPixelFormats 方法 (wincodec.h)
擷取編解碼器支援的圖元格式。
語法
HRESULT GetPixelFormats(
[in] UINT cFormats,
[in, out] GUID *pguidPixelFormats,
[out] UINT *pcActual
);
參數
[in] cFormats
類型: UINT
pguidPixelFormats 陣列的大小。 在第一次呼叫時使用 0
來判斷所需的數位大小。
[in, out] pguidPixelFormats
類型: GUID*
接收支援的像素格式。 第一次呼叫時使用 NULL
來判斷所需的數位大小。
[out] pcActual
類型: UINT*
擷取所有支援的圖元格式所需的數位大小。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
這個方法的使用模式是兩個呼叫程式。
第一個呼叫會擷取擷取所有支援的圖元格式所需的陣列大小,方法是呼叫 cFormats 設定為 0
,並將 pguidPixelFormats 設定為 NULL
。
此呼叫會將 PCActual 設定為所需的數位大小。
一旦決定所需的陣列大小,第二個 GetPixelFormats 呼叫會將 pguidPixelFormats 設定為適當大小的陣列將會擷取圖元格式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincodec.h |
程式庫 | Windowscodecs.lib |
Dll | Windowscodecs.dll |