Methods > IO devices and system mixers > EnableOutputDevice method

Remarks

Enables/disables an output device in order to allow recording on half-duplex devices.

Normal sound cards work in full-duplex, allowing input and output channels working at the same time: some other device used for dictation purposes, like some model of Philips SpeechMike™ devices, work in half duplex so, before starting a recording session, there is the need to disable their sound output functionality through a call to this method with the bEnable parameter set to FALSE; once the recording session has been completed their sound output functionality can be enabled again through a call to this method with the bEnable parameter set to TRUE.

The total number of available output devices can be obtained using the GetOutputDevicesCount method and their friendly description can be obtained using the GetOutputDeviceDesc method.

Syntax

[Visual Basic]

control.EnableOutputDevice (

nIndex As integer

bEnable as enumBoolean

) as enumErrorCodes

[C++]

short control.EnableOutputDevice (

short nIndex,

BOOL bEnable

);

Parameter

Description

nIndex

Number representing the zero-based index of the output device which needs to be enabled/disabled

bEnable

Boolean value that specifies if the given output device must be enabled or disabled.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	Disables the output device
BOOL_TRUE (default)	1	Enables the output device

Return value

Value	Meaning

Negative value	An error occurred. Check the LastError property value in order to see the last error.
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.