Copyright © 2006-2018 MultiMedia Soft

EnableOutputDevice method

Previous pageReturn to chapter overviewNext page

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.