Método IWICBitmapFrameDecode::GetColorContexts (wincodec.h)

Recupera o IWICColorContext associado ao quadro de imagem.

Sintaxe

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

Parâmetros

[in] cCount

Tipo: UINT

O número de contextos de cor a serem recuperados.

Esse valor deve ser do tamanho ou menor do que o tamanho disponível para ppIColorContexts.

[in, out] ppIColorContexts

Tipo: IWICColorContext**

Um ponteiro que recebe um ponteiro para os objetos IWICColorContext .

[out] pcActualCount

Tipo: UINT*

Um ponteiro que recebe o número de contextos de cor contidos no quadro de imagem.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se NULL for passado para ppIColorContexts e 0 for passado para cCount, esse método retornará o número total de contextos de cor na imagem em pcActualCount.

A matriz ppIColorContexts deve ser preenchida com dados válidos: cada IWICColorContext* na matriz deve ter sido criada usando IWICImagingFactory::CreateColorContext.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib