Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 2 - Sound Manager / Sound Manager Reference
Sound Manager Routines / Controlling Volume Levels


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.

SetSysBeepVolume

You can use the SetSysBeepVolume function to set the current volume of the system alert sound.

FUNCTION SetSysBeepVolume (level: LongInt): OSErr;
level
The desired volume level of the system alert sound.
DESCRIPTION
The SetSysBeepVolume function sets the current volume level of the system alert sound. The values you can specify in the high and low words of the level parameter range from 0 (silence) to $0100 (full volume). Any calls to the SysBeep procedure use the volume set by the most recent call to SetSysBeepVolume.

SPECIAL CONSIDERATIONS
The SetSysBeepVolume function is available only in versions 3.0 and later of the Sound Manager. You can call this function at interrupt time.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the SetSysBeepVolume function are
Trap macroSelector
_SoundDispatch$02280024

RESULT CODES
noErr0No error

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996