Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / Constants and Data Types

Profile Location Constants

Profile Location Union

You use a union of type CMProfLoc to identify the location of a profile. You specify the union in the u field of the CMProfileLocation data type (page 3-40). Your application passes a pointer to a CMProfileLocation structure when it calls the CMOpenProfile function to identify the location of a profile or the CMNewProfile, CWNewLinkProfile, or CMCopyProfile functions to specify the location for a newly created profile. You also pass a pointer to a CMProfileLocation structure to the CMGetProfileLocation function to get the location of an existing profile.

union CMProfLoc {
   CMFileLocation    fileLoc; /* specifies location on disk */
   CMHandleLocation  handleLoc;/* specifies location in relocatable memory */
   CMPtrLocation     ptrLoc;  /* specifies location in nonrelocatable
                                 memory */
   CMProcedureLocation procLoc;/* specifies access procedure */
};

Field Description

fileLoc

A data structure containing a file system specification record specifying the location of a profile disk file.

handleLoc

A data structure containing a handle that indicates the location of a profile in relocatable memory.

ptrLoc

A data structure containing a pointer that points to a profile in nonrelocatable memory.

procLoc

A data structure containing a universal procedure pointer that points to a profile access procedure supplied by you. The ColorSync Manager calls your procedure when the profile is created, initialized, opened, read, updated, or closed.