共用方式為


(wincodec.h) IWICBitmapFrameDecode::GetColorContexts 方法

擷取與影像框架相關聯的 IWICColorContext

語法

HRESULT GetColorContexts(
  [in]      UINT             cCount,
  [in, out] IWICColorContext **ppIColorContexts,
  [out]     UINT             *pcActualCount
);

參數

[in] cCount

類型: UINT

要擷取的色彩內容數目。

這個值必須是 ppIColorContexts可用的大小或小於的大小。

[in, out] ppIColorContexts

類型: IWICColorContext**

接收 IWICColorContext 物件指標的指標。

[out] pcActualCount

類型: UINT*

指標,可接收影像框架中包含的色彩內容數目。

傳回值

類型: HRESULT

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

備註

如果 針對ppIColorContexts傳遞 NULL,而針對 cCount 傳遞 0,則此方法會傳回 pcActualCount 中影像中的色彩內容總數。

ppIColorContexts 數位必須填入有效的數據:陣列中的每個 IWICColorContext* 都必須使用 IWICImagingFactory::CreateColorContext 建立。

規格需求

需求
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib