Inside Macintosh: Sound /

Chapter 5 - Sound Components / Sound Components Reference

Sound Component-Defined Routines / Managing Source Data

SoundComponentStartSource

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

pascal ComponentResult SoundComponentStartSource 
                           (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 SoundComponentStartSource function is called by the Sound Manager to begin playing the sounds originating from the sound sources specified by the sources parameter. Your function should start (or resume) sending data from those sources to the associated sound output device. If your component supports only one sound source, you can ignore the sources parameter.

SPECIAL CONSIDERATIONS

Your SoundComponentStartSource function can be called at interrupt time.

RESULT CODES

Your SoundComponentStartSource 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.