Copyright © 2013-2014 MultiMedia Soft

MidiDevices.InfoGet method

Previous pageReturn to chapter overviewNext page

Remarks

 

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

 

For further details about the use of MIDI devices see the ClassMidiDevices class section and the How to manage MIDI devices tutorial.

 

 

Syntax

 

[Visual Basic]

MidiDevices.MidiDevices.InfoGet (

bInput as Boolean,

nDeviceIndex as Int16,

nInfoStringType as enumInfoStringType,

ByRef nVendorId as Int32,

ByRef nProductId as Int32

) as String


 

[C#]

public string MidiDevices.InfoGet (

bool bInput,

Int16 nDeviceIndex,

Int16 nInfoStringType,

ref Int32 nVendorId,

ref Int32 nProductId

);


 

[C++]

public: string MidiDevices.InfoGet (

bool bInput,

Int16 nDeviceIndex,

Int16 nInfoStringType,

Int32 __gc *nVendorId,

Int32 __gc *nProductId

);


 

Parameter

Description

 

 

bInput

Boolean value that specifies if the info request is related to an input or an output device.

Supported values are the following:

Mnemonic constant

Meaning

false

The info request is related to an output device

true

The info request is related to an input device

nDeviceIndex

Number representing the zero-based index of the MIDI device. The number of available MIDI devices installed inside the system can be obtained through the MidiDevices.CountGet method.

nInfoStringType

Specifies the type of information string we want to obtain.

Supported values are the following:

Mnemonic constant

Value

Meaning

INFO_STRING_TYPE_PRODUCT

0

Returns the name of the product only

INFO_STRING_TYPE_VENDOR

1

Returns the name of the product's vendor (manufacturer) only

INFO_STRING_TYPE_VENDOR_PRODUCT

2

Returns the name of the product's vendor (manufacturer) followed by the name of the product

nVendorId

Reference that, on return from the method call, will contain the number representing the vendor's (manufacturer) identifier (also known as VID or MID) 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's identifier (also known as PID) for the MIDI device. The list of known identifiers can be found inside the MSDN website

 

 

Return value

 

Value

Meaning

 

 

Empty string

An error occurred (see the LastError property for further error details)

Valid string

String containing the requested information.