Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 5 - Sound Components / Sound Components Reference
Sound Component-Defined Routines / Managing Source Data


Legacy Documentclose button

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.

SoundComponentStopSource

A sound output device component must implement the SoundComponentStopSource function. The Sound Manager calls this function to stop playing sounds in one or more sound channels.

pascal ComponentResult SoundComponentStopSource 
                           (ComponentInstance ti, short count, 
                              SoundSource *sources);
ti
A component instance that identifies your sound component.
count
The number of source IDs in the array pointed to by the source parameter.
sources
An array of source IDs.
DESCRIPTION
Your SoundComponentStopSource function is called by the Sound Manager to stop the sounds originating from the sound sources specified by the sources parameter. Your function should stop sending data from those sources to the associated sound output device. In addition, your SoundComponentStopSource function should flush any data from the specified sound sources that it's caching. If your component supports only one sound source, you can ignore the sources parameter.

RESULT CODES
Your SoundComponentStopSource function should return noErr if successful or an appropriate result code otherwise. You should return noErr even if no sounds are playing in the specified channels.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996