COM Objects > MIDI object > Methods > MIDI.InputDevicesInfoGet method

Remarks

After completing the enumeration, started through the MIDI.InputDevicesEnum method, of MIDI input devices installed inside the system, allows retrieving information about a specific MIDI input device.

For further details about the use of MIDI protocol see the MIDI object section and the How to deal with MIDI protocol tutorial.

Syntax

[Visual Basic]

control.MIDI.InputDevicesInfoGet (

nDeviceIndex as Integer,

nManufacturerId as Long,

nProductId as Long,

bIsEnabled as enumBoolean,

bIsStarted as enumBoolean

) as String

[C++]

BSTR control.MIDI.InputDevicesInfoGet (

short nDeviceIndex,

long *nManufacturerId,

long *nProductId,

long *bIsEnabled,

long *bIsStarted

);

Parameter

Description

nDeviceIndex

Number representing the zero-based index of the MIDI input device. The number of available MIDI input devices installed inside the system can be obtained directly through the MIDI.InputDevicesEnum method or, after having performed the enumeration, through the MIDI.InputDevicesCountGet method.

nManufacturerId

Reference that, on return from the method call, will contain the number representing the manufacturer identifier for the MIDI device. The list of known identifiers can be found inside the MSDN website

nProductId

Reference that, on return from the method call, will contain the number representing the product identifier for the MIDI device. The list of known identifiers can be found inside the MSDN website

bIsEnabled

Reference that, on return from the method call, will report if the MIDI input device is enabled.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	The MIDI input device is disabled. In this situation a call to the MIDI.InputDevicesStartOnPlayer MIDI.InputDevicesStartOnPlayer method or through the MIDI.InputDevicesStart method will fail.
BOOL_TRUE	1	The MIDI input device is enabled.

bIsStarted

Reference that, on return from the method call, will report if the MIDI input device is started.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	The MIDI input device has not been started.
BOOL_TRUE	1	The MIDI input device has already been started through the MIDI.InputDevicesStartOnPlayer MIDI.InputDevicesStartOnPlayer method or through the MIDI.InputDevicesStart method

Return value

Value	Meaning

Empty string	An error occurred (see the LastError property for further error details)
Valid string	String containing the friendly name of the MIDI input device