ITTSAttributes::PitchSet

HRESULT PitchSet(WORD wPitch);

Sets the baseline pitch for a text-to-speech mode.

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

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

wPitch

[in] New baseline pitch for the voice, in hertz. If the value is out of range for the engine, an error is returned and the pitch is not changed. An application can specify TTSATTR_MINPITCH or TTSATTR_MAXPITCH for minimum or maximum allowable values.

The actual pitch of the voice typically fluctuates above this baseline. It usually does not go below it.