Carbon


CMProfLoc

Header: CMApplication.h

union CMProfLoc {
    CMFileLocation fileLoc; 
    CMHandleLocation handleLoc; 
    CMPtrLocation ptrLoc; 
    CMProcedureLocation procLoc; 
    CMPathLocation pathLoc; 
    CMBufferLocation bufferLoc;
};

Field descriptions

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.

pathLoc
bufferLoc

You use a union of type CMProfLoc to identify the location of a profile. You specify the union in the u field of the data type CMProfileLocation. 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, CMCopyProfile, or CWNewLinkProfile functions to specify the location for a newly created profile.

You also pass a pointer to a CMProfileLocation structure to the NCMGetProfileLocation and CMGetProfileLocation functions to get the location of an existing profile. The NCMGetProfileLocation function is available starting with ColorSync version 2.5. It differs from its predecessor, CMGetProfileLocation, in that the newer version has a parameter for the size of the location structure for the specified profile.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)