saiAsrGetNewAudioChannel

Retrieves whether or not the client can request that the media server obtain audio data from a new audio source.

Prototype

DWORD saiAsrGetNewAudioChannel ( SAI_RECOGNIZER_HANDLE recogHd, BOOL *value )

Argument

Description

recogHd

Handle associated with a recognizer resource.

value

Pointer to one of the following values:

  • TRUE: Client can request audio data from an alternate source.

  • FALSE: Client cannot request audio data from an alternate source.


Return values

Return value

Description

SUCCESS

 

SAIERR_INVALID_PARAMETER

One of the specified arguments is invalid.

SAIERR_UNSUPPORTED_SPEECH_PARAMETER

Recognizer engine does not support the specified parameter.


Details

When saiAsrGetNewAudioChannel is set to TRUE, the recognizer must discard all collected information or line statistics and start fresh for the new recognizer request.

Applications can call saiAsrGetNewAudioChannel to reuse an open recognition session on the media server for multiple telephone calls. This function enables applications to avoid any delay associated with creating a new recognizer and specifying new configuration parameters for that recognizer.

See also

saiAsrSetNewAudioChannel