Contents

MIDIObjectFindByUniqueID(_:_:_:)

Locates a device, entity, or endpoint by its unique identifier.

Declaration

func MIDIObjectFindByUniqueID(_ inUniqueID: MIDIUniqueID, _ outObject: UnsafeMutablePointer<MIDIObjectRef>?, _ outObjectType: UnsafeMutablePointer<MIDIObjectType>?) -> OSStatus

Parameters

  • inUniqueID:

    The unique ID of the object to search for. You determine the unique ID by querying Midiobjectgetintegerproperty(_:_:_:) for the Kmidipropertyuniqueid property.

  • outObject:

    The returned object, or 0 if the object wasn’t found or an error occurred. Cast this pointer to the appropriate type, according to type specified by the outObjectType argument.

  • outObjectType:

    On exit, the type of object found, or undefined if the system found no objects.

Return Value

An OSStatus error code, including kMIDIObjectNotFound if there is no object with this unique ID.

Topics

Parameter Types

See Also

MIDI object configuration