![]() |
SoundComponentInitOutputDevice |
||||
Header: | Sound.h | Carbon status: | Supported | |
Allows a sound output device component to configure any associated hardware devices. A sound output device component must implement the SoundComponentInitOutputDevice function.
ComponentResult SoundComponentInitOutputDevice ( ComponentInstance ti, SInt32 actions );
A component instance that identifies your sound component.
A set of flags. This parameter is currently unused.
Returns noErr if successful or an appropriate result code otherwise.
Your SoundComponentInitOutputDevice function is called by the Sound Manager at noninterrupt time to allow your sound output device component to perform any hardware-specific initialization. You should perform any necessary initialization that was not already performed in your OpenComponent function. Note that your OpenComponent function cannot assume that the appropriate hardware is available. As a result, the Sound Manager calls your SoundComponentInitOutputDevice function when it is safe to communicate with your audio hardware. You can call the OpenMixerSoundComponent function to create a single sound component chain.
Your SoundComponentInitOutputDevice function is always called at noninterrupt time. All other component-defined functions might be called at interrupt time. Accordingly, your SoundComponentInitOutputDevice function should handle any remaining memory allocation needed by your component and it should lock down any relocatable blocks your component will access.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)