CMProfileIterateProcPtr
Defines a pointer to a profile iteration callback function that the ColorSync Manager calls for each found profile file as it iterates over the available profiles.
Declaration
typedef OSErr (*CMProfileIterateProcPtr)(CMProfileIterateData *iterateData, void *refCon);Parameters
- iterateData:
A pointer to a structure of type Cmprofileiteratedata. When the function 1804904 Cmiteratecolorsyncfolder calls
MyProfileIterateCallback, as it does once for each found profile, the structure contains key information about the profile. - refCon:
An untyped pointer to arbitrary data your application previously passed to the function 1804904 Cmiteratecolorsyncfolder.
Return Value
An OSErr value. If MyCMProfileIterateCallback returns an error, CMIterateColorSyncFolder stops iterating and returns the error value to its caller (presumably your code).
Discussion
When your application needs information about the profiles currently available in the profiles folder, it calls the function , which, depending on certain conditions, calls your callback routine once for each profile. See the description of CMIterateColorSyncFolder for information on when it calls the MyCMProfileIterateCallback function.
Your MyCMProfileIterateCallback function examines the structure pointed to by the iterateData parameter to obtain information about the profile it describes. The function determines whether to do anything with that profile, such as list its name in a pop-up menu of available profiles.
See Also
Callbacks
CMBitmapCallBackProcPtrCMConcatCallBackProcPtrCMCountImageProfilesProcPtrCMEmbedImageProcPtrCMFlattenProcPtrCMGetImageSpaceProcPtrCMGetIndImageProfileProcPtrCMIterateDeviceInfoProcPtrCMIterateDeviceProfileProcPtrCMLinkImageProcPtrCMMatchImageProcPtrCMMIterateProcPtrCMProofImageProcPtrCMSetIndImageProfileProcPtrCMUnembedImageProcPtrCMValidImageProcPtrCountImageProfilesProcPtrEmbedImageProcPtrGetImageSpaceProcPtrGetIndImageProfileProcPtrMatchImageProcPtrSetIndImageProfileProcPtrUnembedImageProcPtrValidateImageProcPtrValidateSpaceProcPtr