Important: Inside Macintosh: Sound is deprecated as of Mac OS X v10.5. For new audio development in Mac OS X, use Core Audio. See the Audio page in the ADC Reference Library.
StopSpeech
You can use theStopSpeech
function to terminate speech immediately on a specified channel.
FUNCTION StopSpeech (chan: SpeechChannel): OSErr;
chan
- The speech channel on which speech is to be stopped.
DESCRIPTION
TheStopSpeech
function immediately terminates speech on the channel specified by thechan
parameter. After returning fromStopSpeech
, your application can safely release any text buffer that the speech synthesizer has been using. You can callStopSpeech
for an already idle channel without ill effect.You can also stop speech by passing a zero-length string (or, in C, a
null
pointer) to one of theSpeakString
,SpeakText
, orSpeakBuffer
functions. Doing this stops speech only in the specified speech channel (or, in the case ofSpeakString
, in the speech channel managed internally by the Speech Manager).SPECIAL CONSIDERATIONS
Because theStopSpeech
function might move or purge memory, you should not call it at interrupt time.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theStopSpeech
function are
Trap macro Selector _SoundDispatch
$022C000C RESULT CODES
noErr 0 No error invalidComponentID -3000 Speech channel is uninitialized or bad SEE ALSO
Before calling theStopSpeech
function, you can use theSpeechBusy
function, which is described on page 4-72, to determine if a synthesizer is still speaking. If you are working with multiple speech channels, you can use the status selector with the routineGetSpeechInfo
which is described on page 4-77, to determine if a specific channel is still speaking.