ssCore.MIDI.getInfo

Retrieve MIDI device capability information.


Availability:

First available in version 3.2 build 136.


Input Parameters:

None.


Output Parameters:

result - MIDI device information, in XML format.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.MIDI.getInfo( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.MIDI.getInfo( paramsObject );


Notes:

The MIDI information is returned in XML format with a midi_device node for each installed device that contains information such as the device ID, the manufacturer ID (in hexadecimal), the product ID (in hexadecimal), the manufacturer's name for the device, and the version of the driver software (0 padded), as in the example below (line breaks have been added to improve readability).

<midi_devices>
    <midi_device
        id='0'
        mid='00000069'
        pid='00000019'
        name='In+USB+Keystation'
        ver='065.021' />
    <midi_device
        id='1'
        mid='00000001'
        pid='00000067'
        name='SB+PCI+External+MIDI'
        ver='005.000' />
</midi_devices>

If no MIDI devices are attached, an XML tree with no <midi_device> nodes will be returned.

<midi_devices>
</midi_devices>

                

Examples:

var return_obj = ssCore.MIDI.getInfo();

ssDebug.trace(return_obj.result);