Methods > Init and info > EnableOutputDevice method

Remarks

Enables/disables access to the system default output device for playback of the sound under editing.

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, in order to let other components and/or applications accessing this device, there is the need to disable the control's sound output functionality through a call to this method with the bEnable parameter set to FALSE; once other components and/or applications has completed their task, the sound output functionality can be enabled again through a call to this method with the bEnable parameter set to TRUE.

Syntax

[Visual Basic]

control.EnableOutputDevice (

nIndex As integer

bEnable as enumBoolean

) as enumErrorCodes

[C++]

short control.EnableOutputDevice (

short nIndex,

BOOL bEnable

);

Parameter

Description

nIndex

Must be set to -1.

bEnable

Boolean value that specifies if output devices must be enabled or disabled.

Supported values are the following:

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

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.