Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GetColorProfileHeader Function

The GetColorProfileHeader function retrieves or derives ICC header structure from either ICC color profile or WCS XML profile. Drivers and applications should assume returning TRUE only indicates that a properly structured header is returned. Each tag will still need to be validated independently using either legacy ICM2 APIs or XML schema APIs.

Syntax

BOOL WINAPI GetColorProfileHeader(
    HPROFILE hProfile,
    PPROFILEHEADER pHeader
);

Parameters

hProfile

Specifies a handle to the color profile in question.

pHeader

Points to a variable in which the ICC header structure is to be placed.

Return Value

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. This function will fail is an invalid ICC or WCS XML profile is referenced in the hProfile parameter. For extended error information, call GetLastError.

Remarks

To determine whether the header is derived from an ICC or DMP profile handle, check the header signature (header bytes 36-39). If the signature is "acsp" (big endian) then an ICC profile was used. If the signature is "cdmp" (big-endian) then a DMP was used.

The distinguishing features that identify a header as having been "synthesized" for a WCS DMP are:

pIcmProfileHeader->phSignature = 'pmdc' (little endian = big endian 'cdmp')

pIcmProfileHeader->phCMMType = '1scw' (little endian = big endian 'wcs1').

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Icm.h

Library

Mscms.lib

DLL

Mscms.dll

See Also

Basic Color Management Concepts
Functions
PROFILEHEADER

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2010

Community Additions

Show:
© 2014 Microsoft