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.
SoundComponentSetInfo
A sound component must implement theSoundComponentSetInfo
function. The Sound Manager calls this function to modify settings of your component.
pascal ComponentResult SoundComponentSetInfo (ComponentInstance ti, SoundSource sourceID, OSType selector, void *infoPtr);
ti
- A component instance that identifies your sound component.
sourceID
- A source ID for a source component chain.
selector
- A sound component information selector. See "Sound Component Information Selectors" beginning on page 5-22 for a description of the available selectors.
infoPtr
- A pointer to the information your component is to use to modify its settings. If the information occupies 4 or fewer bytes, however, this parameter contains the information itself, not the address of the information.
DESCRIPTION
Your SoundComponentSetInfo function is called by the Sound Manager to set one of the settings for your component, as specified by theselector
parameter. If the information associated with that selector occupies 4 or fewer bytes, it is passed on the stack, in theinfoPtr
parameter itself. Otherwise, theinfoPtr
parameter is a pointer to a structure of typeSoundInfoList
. See the description ofSoundComponentGetInfo
for more information about theSoundInfoList
structure.If your component cannot modify the settings specified by the
selector
parameter, it should pass the selector to its source component.RESULT CODES
Your SoundComponentSetInfo function should returnnoErr
if successful or an appropriate result code otherwise.