Metodo IWICBitmapFrameDecode::GetColorContexts (wincodec.h)

Recupera l'oggetto IWICColorContext associato al frame dell'immagine.

Sintassi

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

Parametri

[in] cCount

Tipo: UINT

Numero di contesti di colore da recuperare.

Questo valore deve essere la dimensione di o minore di quella disponibile per ppIColorContexts.

[in, out] ppIColorContexts

Tipo: IWICColorContext**

Puntatore che riceve un puntatore agli oggetti IWICColorContext .

[out] pcActualCount

Tipo: UINT*

Puntatore che riceve il numero di contesti di colore contenuti nella cornice dell'immagine.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se viene passato NULL per ppIColorContexts e 0 viene passato per cCount, questo metodo restituirà il numero totale di contesti di colore nell'immagine in pcActualCount.

La matrice ppIColorContexts deve essere compilata con dati validi: ogni IWICColorContext* nella matrice deve essere stato creato usando IWICImagingFactory::CreateColorContext.

Requisiti