EnableOutputDevice method

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]

Public Function EnableOutputDevice (

nOutputIndex as Int16,

bEnable as bool

) as enumErrorCodes

[C#]

public enumErrorCodes EnableOutputDevice (

Int16 nOutputIndex,

bool bEnable

);

[C++]

public: enumErrorCodes EnableOutputDevice (

Int16 nOutputIndex,

bool bEnable

);

Parameter

Description

nOutputIndex

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

bEnable

Boolean value that tells 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.

Return to Table of contents