IGamutMapModelPlugIn::Initialize

Initializes a gamut map model profile (GMMP) by using the specified source and destination gamut boundary descriptions and optional source and destination device model plug-ins.

HRESULT IGamutMapModelPlugIn::Initialize(
  [in] BSTR bstrXml,
  [in] IDeviceModelPlugIn *pSrcPlugIn,
  [in] IDeviceModelPlugIn *pDestPlugIn,
  [in] GamutBoundaryDescription *pSrcGBD,
  [in] GamutBoundaryDescription *pDestGBD);

Parameters

  • bstrXml
    A string that contains the BSTR XML GMMP profile. This is little-endian Unicode XML, but without the leading bytes to tag it as such. Also, the encoding keyword in the XML may not reflect this format.
  • *pSrcPlugIn
    A pointer to a source IDeviceModelPlugIn. If NULL, it indicates the source device model profile is not a plug-in profile.
  • *pDestPlugIn
    A pointer to a destination IDeviceModelPlugIn. If NULL, it indicates the destination device model profile is not a plug-in profile.
  • *pSrcGBD
    A pointer to a source GamutBoundaryDescription.
  • *pDestGBD
    A pointer to a destination GamutBoundaryDescription.

Return Values

If this function succeeds, the return value is S_OK.

If this function fails, the return value is E_FAIL.

Requirements

**  Windows Vista:** Included in Windows Vista and later.
**  Header:** Declared in WcsPlugIn.h.

See Also

Basic Color Management Concepts