ColorProfileAddDisplayAssociation function (icm.h)

Article
02/22/2024

Associates an installed color profile with a specified display in the given scope.

Syntax

HRESULT ColorProfileAddDisplayAssociation(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       profileName,
  LUID                         targetAdapterID,
  UINT32                       sourceID,
  BOOL                         setAsDefault,
  BOOL                         associateAsAdvancedColor
);

Parameters

scope

Specifies the association as system-wide or the current user.

profileName

Identifies the installed profile to associate.

targetAdapterID

An identifier assigned to the adapter (e.g. GPU) of the target display. See Remarks for more details.

sourceID

An identifier assigned to the source of the display. See Remarks for more details.

setAsDefault

Whether or not to set the newly associated profile as the default.

associateAsAdvancedColor

Specifies to which association list the new profile is added.

Return value

S_OK for success, or a failure HRESULT value

Remarks

See connecting and configuring displays for information on display adapter IDs and source IDs.

Requirements

Requirement	Value
Minimum supported client	Windows 10 Build 20348
Minimum supported server	Windows 10 Build 20348
Header	icm.h