Controls a synthesizer process.
DWORD saiControlSynthesizer ( SAI_SYNTHESIZER_HANDLE synthHd, SAI_REQUEST_ID *requestId )
|
Argument |
Description |
|
synthHd |
Handle associated with a synthesizer resource. |
|
requestId |
Pointer to a unique identifier associated with the request. |
|
Return value |
Description |
|
SUCCESS |
|
|
SAIERR_ENGINE_NOT_READY |
Specified synthesizer engine is not ready to handle the request. |
|
SAIERR_INVALID_PARAMETER |
One of the specified arguments is invalid. |
|
Event |
Description |
|
SAIEVN_TTS_CONTROL_DONE |
Request was processed. The result of the request is returned in the statusCode field of the SAIEVN_TTS_CONTROL_DONE event buffer. |
saiControlSynthesizer sends a message to the specified speech synthesizer engine to modify what it is currently being spoken. saiControlSynthesizer enables applications to jump forward and backward through the spoken text, changing speech rate and modifying other speech parameters for the active (IN-PROGRESS) speak request.
Prior to invoking saiControlSynthesizer, the application must set speech control parameters with one of the following functions:
|
This function... |
Sets the... |
|
Voice parameters for the speech data. | |
|
Prosody parameters for the speech data. |
saiPauseSynthesizer, saiResumeSynthesizer, saiSpeakSynthesizer, saiStopSynthesizer