| |
Abstract: Return one of the devices in the system.
extern MIDIDeviceRef MIDIGetDevice( ItemCount deviceIndex0 );
Use this to enumerate the devices in the system.
To enumerate the entities in the system, you can walk through
the devices, then walk through the devices' entities.
Note: If a client iterates through the devices and entities
in the system, it will not ever visit any virtual sources and
destinations created by other clients. Also, a device
iteration will return devices which are "offline"
(were present in the past but are not currently present),
while iterations through the system's sources and destinations
will not include the endpoints of offline devices.
Thus clients should usually prefer MIDIGetNumberOfSources,
MIDIGetSource, MIDIGetNumberOfDestinations and MIDIGetDestination to
iterating through devices and entities to locate endpoints.
Parameters
| Name | Description |
|---|
| deviceIndex0 | The index (0...MIDIGetNumberOfDevices()-1) of the device
to return. |
Result: A reference to a device, or NULL if an error occurred.
|