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.
AudioSetVolume
An audio component can implement theAudioSetVolume
function. The Sound Manager calls this function to set the current volume of an audio port.
pascal ComponentResult AudioSetVolume (ComponentInstance ac, short whichChannel, ShortFixed volume);
ac
- A component instance that identifies your audio component.
whichChannel
- The channel or channels whose volume you should set.
volume
- The desired volume level of the specified channel.
DESCRIPTION
YourAudioSetVolume
function is called by the Sound Manager to set the volume levels of one or more channels of an audio port. See the description of theAudioGetVolume
function for the values of thewhichChannel
andvolume
parameters.RESULT CODES
YourAudioSetVolume
function should returnnoErr
if successful or an appropriate result code otherwise. In particular, if your audio component doesn't support software control of volume levels,AudioSetVolume
should returnunImpErr
.