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]

Public Function EnableOutputDevice (

nOutputIndex as Int16,

bEnable as Boolean

) as enumErrorCodes

[C#]

public enumErrorCodes EnableOutputDevice (

Int16 nOutputIndex,

bool bEnable

);

[C++]

public: enumErrorCodes EnableOutputDevice (

Int16 nOutputIndex,

bool bEnable

);

Parameter

Description

nOutputIndex

Must be set to -1.

bEnable

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

Supported values are the following:

Value	Meaning
false	Disables the output device
true (default)	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.