Share via


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