ID2D1DeviceContext::CreateColorContextFromFilename method

Creates a color context by loading it from the specified filename. The profile bytes are the contents of the file specified by Filename.

Syntax


HRESULT CreateColorContextFromFilename(
  PCWSTR Filename,
  [out]  ID2D1ColorContext **colorContext
);

Parameters

Filename

Type: PCWSTR

The path to the file containing the profile bytes to initialize the color context with.

colorContext [out]

Type: ID2D1ColorContext**

When this method returns, contains the address of a pointer to a new color context.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULTDescription
S_OKNo error occurred.
E_OUTOFMEMORYDirect2D could not allocate sufficient memory to complete the call.
E_INVALIDARGAn invalid value was passed to the method.

 

Remarks

The new color context can be used in D2D1_BITMAP_PROPERTIES1 to initialize the color context of a created bitmap. The model field of the profile header is inspected to determine whether this profile is sRGB or scRGB and the color space is updated respectively. Otherwise the space is custom.

Requirements

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

D2d1_1.h

DLL

D2d1.dll

See also

ID2D1DeviceContext
D2D1_BITMAP_PROPERTIES1
ID2D1Bitmap1

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.