# saiControlSynthesizer

Controls a synthesizer process.

#### Prototype

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 values

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.

#### Events

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.

#### Details

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...
saiTtsSetVoice | Voice parameters for the speech data.
saiTtsSetProsody | Prosody parameters for the speech data.

#### See also

saiPauseSynthesizer, saiResumeSynthesizer, saiSpeakSynthesizer, saiStopSynthesizer