ID2D1DeviceContext::CreateColorContextFromFilename method (d2d1_1.h)

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.

[out] colorContext

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.

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An 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

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1_1.h
DLL D2d1.dll

See also

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext