kMIDIPropertyNameConfiguration

const CFStringRef kMIDIPropertyNameConfiguration;

device/entity/endpoint property, CFDictionary

This specifies the device's current patch, note and control name values using the MIDINameDocument XML format. This specification requires the use of higher-level, OS-specific constructs outside of the specification, to fully define the current names for a device.

The MIDINameConfiguration property is implementated as a CFDictionary:

key "master" maps to a CFDataRef containing an AliasHandle referring to the device's master name document.

key "banks" maps to a CFDictionaryRef. This dictionary's keys are CFStringRef names of patchBank elements in the master document, and its values are each a CFDictionaryRef: key "file" maps to a CFDataRef containing an AliasHandle to a document containing patches that override those in the master document, and key "patchNameList" maps to a CFStringRef which is the name of the patchNameList element in the overriding document.

key "currentModes" maps to a 16-element CFArrayRef, each element of which is a CFStringRef of the name of the current mode for each of the 16 MIDI channels.

Clients setting this property must take particular care to preserve dictionary values other than the ones they are interested in changing, and to properly structure the dictionary.

New for CoreMIDI 1.3.



[ Search xmidi.com:    ]


[ home | docs | apps | links ]