ITTSCentral::Inject

HRESULT Inject( TCHAR *pszTag);

Injects text-to-speech control tags into the text currently being spoken.

· Returns NOERROR if successful, or one of these error values:

<E_INVALIDARG>
<E_OUTOFMEMORY>
<TTSERR_INVALIDCHAR>
<TTSERR_NOTSUPPORTED>
<TTSERR_VALUEOUTOFRANGE>

pszTag

[out] Address of a string that contains the tag to inject. A string can contain multiple tags, separated by spaces. The tags in the string should be in the same format as tags embedded in text — for example, "\Spd=360\ \Vce=Gender="Female"\".

Do not use Inject to inject bookmark tags (Mrk).

An application can use this member function to control speaking parameters on the fly without having to reconstruct the text-to-speech buffers. If the engine understands a tag, it should act on the tag as soon as possible after receiving it.