Methods > Output devices and system mixers > GetOutputDeviceDesc method

Remarks

Retrieves the friendly description of the requested output device (sound card). This method is useful when you have to fill a combo box with the friendly names of available output devices.

The total number of available output devices can be obtained using the GetOutputDevicesCount method.

For further details about speakers assignment, take a look to the How to work with multiple output devices and speakers section.

Syntax

[Visual Basic]

Public Function GetOutputDeviceDesc (

nOutputIndex as Int16

) as String

[C#]

public string GetOutputDeviceDesc (

Int16 nOutputIndex

);

[C++]

public: string GetOutputDeviceDesc (

Int16 nOutputIndex

);

Parameter	Description

nOutputIndex	Number representing the zero-based index of the output device whose friendly name must be retrieved

Return value

Value	Meaning

Empty string	The value of the nOutputIndex parameter was out of range. Use the value returned by the GetOutputDevicesCount method in order to know how many output devices are currently installed on the system.
Valid string	The string containing the friendly description of the requested output device.