xmidi.com
 

MIDIDestinationCreate

Abstract: Create a virtual destination in a client.

extern OSStatus MIDIDestinationCreate( MIDIClientRef client, 
 CFStringRef name, 
 MIDIReadProc readProc, 
 void * refCon, 
 MIDIEndpointRef * outDest );

Clients may use this to create virtual destinations.

The specified readProc gets called when clients send MIDI to your virtual destination.

Drivers need not call this; when they create devices and entities, sources and destinations are created at that time.

See the discussion of kMIDIPropertyAdvanceScheduleTimeMuSec for notes about the relationship between when a sender sends MIDI to the destination and when it is received.

Parameters

NameDescription
clientThe client owning the virtual destination.
nameThe name of the virtual destination.
readProcThe MIDIReadProc to be called when a client sends MIDI to the virtual destination.
refConThe refCon to be passed to the readProc.
outDestOn successful return, a pointer to the newly-created destination.
Result: An OSStatus result code.
{  Search xmidi.com:     }


[ home | docs | apps | links ]