Enumerations



Error Constants


The error constants unique to Core MIDI.

enum { 
    kMIDIInvalidClient = -10830, 
    kMIDIInvalidPort = -10831, 
    kMIDIWrongEndpointType = -10832, 
    kMIDINoConnection = -10833, 
    kMIDIUnknownEndpoint = -10834, 
    kMIDIUnknownProperty = -10835, 
    kMIDIWrongPropertyType = -10836, 
    kMIDINoCurrentSetup = -10837, 
    kMIDIMessageSendErr = -10838, 
    kMIDIServerStartErr = -10839, 
    kMIDISetupFormatErr = -10840, 
    kMIDIWrongThread = -10841, 
    kMIDIObjectNotFound = -10842, 
    kMIDIIDNotUnique = -10843 
}; 
Constants
kMIDIInvalidClient
An invalid MIDIClientRef was passed.
kMIDIInvalidPort
An invalid MIDIPortRef was passed.
kMIDIWrongEndpointType
A source endpoint was passed to a function expecting a destination, or vice versa.
kMIDINoConnection
Attempt to close a non-existant connection.
kMIDIUnknownEndpoint
An invalid MIDIEndpointRef was passed.
kMIDIUnknownProperty
Attempt to query a property not set on the object.
kMIDIWrongPropertyType
Attempt to set a property with a value not of the correct type.
kMIDINoCurrentSetup
Internal error; there is no current MIDI setup object.
kMIDIMessageSendErr
Communication with MIDIServer failed.
kMIDIServerStartErr
Unable to start MIDIServer.
kMIDISetupFormatErr
Unable to read the saved state.
kMIDIWrongThread
A driver is calling a non-I/O function in the server from a thread other than the server's main thread.
kMIDIObjectNotFound
The requested object does not exist.
kMIDIIDNotUnique
Attempt to set a non-unique kMIDIPropertyUniqueID on an object.
Discussion

These are the error constants that are unique to Core MIDI. Note that Core MIDI functions may return other codes that are not listed here.


MIDIObjectType


Signifies the type of a MIDIObject.

enum { // MIDIObjectType 
    kMIDIObjectType_Other = -1, 
    kMIDIObjectType_Device = 0, 
    kMIDIObjectType_Entity = 1, 
    kMIDIObjectType_Source = 2, 
    kMIDIObjectType_Destination = 3,  
    kMIDIObjectType_ExternalMask = 0x10, 
    kMIDIObjectType_ExternalDevice = kMIDIObjectType_ExternalMask | kMIDIObjectType_Device, 
    kMIDIObjectType_ExternalEntity = kMIDIObjectType_ExternalMask | kMIDIObjectType_Entity, 
    kMIDIObjectType_ExternalSource = kMIDIObjectType_ExternalMask | kMIDIObjectType_Source, 
    kMIDIObjectType_ExternalDestination = kMIDIObjectType_ExternalMask | kMIDIObjectType_Destination 
}; 
Discussion

Signifies the real type of a MIDIObjectRef instance.


MIDINotificationMessageID


Signifies the type of a MIDINotification.

enum { // MIDINotificationMessageID 
    kMIDIMsgSetupChanged = 1, 
    kMIDIMsgObjectAdded = 2, 
    kMIDIMsgObjectRemoved = 3, 
    kMIDIMsgPropertyChanged = 4, 
    kMIDIMsgThruConnectionsChanged = 5, 
    kMIDIMsgSerialPortOwnerChanged = 6, 
    kMIDIMsgIOError = 7 
}; 
Constants
kMIDIMsgSetupChanged
Some aspect of the current MIDISetup has changed. No data. Should ignore this message if messages 2-6 are handled.
kMIDIMsgObjectAdded
A device, entity or endpoint was added. Structure is MIDIObjectAddRemoveNotification. New for CoreMIDI 1.3.
kMIDIMsgObjectRemoved
A device, entity or endpoint was removed. Structure is MIDIObjectAddRemoveNotification. New for CoreMIDI 1.3.
kMIDIMsgPropertyChanged
An object's property was changed. Structure is MIDIObjectPropertyChangeNotification. New for CoreMIDI 1.3.
kMIDIMsgThruConnectionsChanged
A persistent MIDI Thru connection was created or destroyed. No data. New for CoreMIDI 1.3.
kMIDIMsgSerialPortOwnerChanged
A persistent MIDI Thru connection was created or destroyed. No data. New for CoreMIDI 1.3.
kMIDIMsgIOError
A driver I/O error occurred.

(Last Updated February 25, 2005)