Classes > ClassMidiDevices class > Methods > MidiDevices.InfoGetByUniqueId method

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.InfoGetByUniqueId (

bInput as Boolean,

nDeviceUniqueId as Int16,

nInfoStringType as enumInfoStringType,

ByRef nVendorId as Int32,

ByRef nProductId as Int32

) as String

[C#]

public string MidiDevices.InfoGetByUniqueId (

bool bInput,

Int16 nDeviceUniqueId,

Int16 nInfoStringType,

ref Int32 nVendorId,

ref Int32 nProductId

);

[C++]

public: string MidiDevices.InfoGetByUniqueId (

bool bInput,

Int16 nDeviceUniqueId,

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	Value	Meaning
BOOL_FALSE	0	The info request is related to an output device
BOOL_TRUE	1	The info request is related to an input device

nDeviceUniqueId

The unique identifier of the MIDI output device returned by a previous call to the MidiDevices.Open 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.