Export (0) Print
Expand All

IWICBitmapFrameDecode::GetColorContexts method

Retrieves the IWICColorContext associated with the image frame.

Syntax


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

Parameters

cCount [in]

Type: UINT

The number of color contexts to retrieve.

This value must be the size of, or smaller than, the size available to ppIColorContexts.

ppIColorContexts [in, out]

Type: IWICColorContext**

A pointer that receives a pointer to the IWICColorContext objects.

pcActualCount [out]

Type: UINT*

A pointer that receives the number of color contexts contained in the image frame.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If NULL is passed for ppIColorContexts, and 0 is passed for cCount, this method will return the total number of color contexts in the image in pcActualCount.

The ppIColorContexts array must be filled with valid data: each IWICColorContext* in the array must have been created using IWICImagingFactory::CreateColorContext.

Requirements

Minimum supported client

Windows XP with SP2, Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Wincodec.h

IDL

Wincodec.idl

Library

Windowscodecs.lib

 

 

Community Additions

ADD
Show:
© 2014 Microsoft