IWICFormatConverterInfo：：GetPixelFormats 方法 (wincodec.h)

擷取 GUID 清單，表示轉換子所支援的像素格式。

語法

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

參數

[in] cFormats

類型： UINT

pPixelFormatGUIDs 陣列的大小。

[in, out] pPixelFormatGUIDs

類型： WICPixelFormatGUID*

接收轉換器所支援圖元格式之 GUID 陣列的指標。

[out] pcActual

類型： UINT*

擷取轉換器支援的所有圖元格式所需的實際數位大小。

傳回值

類型： HRESULT

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

備註

格式轉換器不一定保證與轉換相關的對稱性;也就是說，轉換子可能能夠從特定格式轉換，而實際上無法轉換成特定格式。 若要測試對稱性，請使用 CanConvert。

若要判斷轉換子可以處理的像素格式數目，請將 cFormats 設定為 0 ，並將 pPixelFormatGUID 設定 為 NULL。 轉換器會將 PCActual 填入該轉換程式所支援的格式數目。

規格需求