Copyright © 2013-2015 MultiMedia Soft

MidiDevices.InfoGetByUniqueId 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 MidiDevices object section and the How to manage MIDI devices tutorial.

 

 

Syntax

 

[Visual Basic]

control.MidiDevices.InfoGetByUniqueId (

bInput as enumBoolean,

nDeviceUniqueId as Integer,

nInfoStringType as enumInfoStringType,

nVendorId as Long,

nProductId as Long

) as String


 

[C++]

BSTR control.MidiDevices.InfoGetByUniqueId (

short bInput,

short nDeviceUniqueId,

short nInfoStringType,

long *nVendorId,

long *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.