Enumeration

Profile Access Procedures

Specify operations used to access profiles.

Declaration

enum : unsigned int {
    ...
};

Overview

When your application calls the CMOpenProfile, CMNewProfile, CMCopyProfile, or CMNewLinkProfile functions, it can supply the ColorSync Manager with a profile location structure of type CMProcedureLocation to specify a procedure that provides access to a profile. The ColorSync Manager calls your procedure when the profile is created, initialized, opened, read, updated, or closed. The profile access procedure declaration is described in CMProfileAccessProcPtr.

When the ColorSync Manager calls your profile access procedure, it passes one of these constants in the command parameter to specify an operation. Your procedure must be able to respond to each of these constants.

Topics

Constants

cmOpenWriteAccess

Open the profile for writing. The total size of the profile is specified in the size parameter.

cmReadAccess

Read the number of bytes specified by the size parameter.

cmWriteAccess

Write the number of bytes specified by the size parameter.

cmCloseAccess

Close the profile for reading or writing.

cmCreateNewAccess

Create a new data stream for the profile.

cmAbortWriteAccess

Cancel the current write attempt.

cmBeginAccess

Begin the process of procedural access. This is always the first operation constant passed to the access procedure. If the call is successful, the cmEndAccess operation is guaranteed to be the last call to the procedure.

cmEndAccess

End the process of procedural access. This is always the last operation constant passed to the access procedure (unless the cmBeginAccess call failed).