ITTSAttributes::RealTimeSet

HRESULT RealTimeSet (DWORD dwRealTime);

Sets the real-time setting for the engine. The real-time setting is the percentage of processor time that the engine expects to use during constant speech.

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

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

dwRealTime

[in] New real-time setting. An application can specify TTSATTR_MINREALTIME or TTSATTR_MAXREALTIME for minimum or maximum allowable values. If the value is out of range for the engine, the member function returns an error, and the real-time setting is not changed.

The engine tries to meet the real-time expectation, but the engine will not be able to consume exactly dwRealTime percentage of the CPU.