| |
Abstract: Locate a device, external device, entity, or endpoint
by its uniqueID.
extern OSStatus MIDIObjectFindByUniqueID( MIDIUniqueID inUniqueID,
MIDIObjectRef * outObject,
MIDIObjectType * outObjectType);
New for CoreMIDI 1.3.
Parameters
| Name | Description |
|---|
| inUniqueID | The uniqueID of the object to search for. (This should
be the result of an earlier call to MIDIObjectGetIntegerProperty
for the property kMIDIPropertyUniqueID). |
| outObject | The returned object, or NULL if the object was not found or
an error occurred. This should be cast to the appropriate
type (MIDIDeviceRef, MIDIEntityRef, MIDIEndpointRef),
according to *outObjectType. |
| outObjectType | On exit, the type of object which was found; undefined
if none found. |
Result: An OSStatus error code, including kMIDIObjectNotFound if there
is no object with the specified uniqueID.
|