Retrieves whether or not kill-on-barge-in support is enabled for a specified synthesizer.
DWORD saiTtsGetKillOnBargeIn ( SAI_SYNTHESIZER_HANDLE synthHd, BOOL *value )
|
Argument |
Description |
|
synthHd |
Handle associated with a synthesizer resource. |
|
value |
Pointer to one of the following values:
|
|
Return value |
Description |
|
SUCCESS |
|
|
SAIERR_INVALID_PARAMETER |
One of the specified arguments is invalid. |
|
SAIERR_UNSUPPORTED_SPEECH_PARAMETER |
Speech engine does not support the specified parameter. |
When kill-on-barge-in is enabled, the synthesizer stops all active or pending speech requests when it is notified of a barge-in condition. If the recognizer and the synthesizer are in the same session, the recognizer engine can notify the synthesizer engine of barge-in detection and ask the synthesizer to immediately stop all speech requests. In both cases, the application performs the same action, except that the synthesizer is notified earlier when the recognizer and synthesizer are in the same session.
For more information, refer to Implementing a barge-in enabled prompt.