Inside Macintosh: Sound /

Chapter 2 - Sound Manager / Sound Manager Reference

Constants

Gestalt Selector and Response Bits

You can pass the gestaltSoundAttr selector to the Gestalt function to determine information about the sound capabilities of a Macintosh computer.

CONST
   gestaltSoundAttr           = 'snd ';   {sound attributes selector}

The Gestalt function returns information by setting or clearing bits in the response parameter. The bits currently used are defined by constants. Note that most of these bits provide information about the built-in hardware only.

IMPORTANT

Bits 7 through 12 are not defined for versions of the Sound Manager prior to version 3.0.

CONST
   gestaltStereoCapability    = 0;     {built-in hw can play stereo sounds}
   gestaltStereoMixing        = 1;     {built-in hw mixes stereo to mono}
   gestaltSoundIOMgrPresent   = 3;     {sound input routines available}
   gestaltBuiltInSoundInput   = 4;     {built-in input hw available}
   gestaltHasSoundInputDevice = 5;     {sound input device available}
   gestaltPlayAndRecord       = 6;     {built-in hw can play while recording}
   gestalt16BitSoundIO        = 7;     {built-in hw can handle 16-bit data}
   gestaltStereoInput         = 8;     {built-in hw can record stereo sounds}
   gestaltLineLevelInput      = 9;     {built-in input hw needs line level}
   gestaltSndPlayDoubleBuffer = 10;    {play from disk routines available}
   gestaltMultiChannels       = 11;    {multiple channels of sound supported}
   gestalt16BitAudioSupport   = 12;    {16-bit audio data supported}

Constant descriptions

gestaltStereoCapability

Set if the built-in sound hardware is able to produce stereo sounds.

gestaltStereoMixing

Set if the built-in sound hardware mixes both left and right channels of stereo sound into a single audio signal for the internal speaker.

gestaltSoundIOMgrPresent

Set if the Sound Input Manager is available.

gestaltBuiltInSoundInput

Set if a built-in sound input device is available.

gestaltHasSoundInputDevice

Set if a sound input device is available. This device can be either built-in or external.

gestaltPlayAndRecord

Set if the built-in sound hardware is able to play and record sounds simultaneously. If this bit is clear, the built-in sound hardware can either play or record, but not do both at once. This bit is valid only if the gestaltBuiltInSoundInput bit is set, and it applies only to any built-in sound input and output hardware.

gestalt16BitSoundIO

Set if the built-in sound hardware is able to play and record 16-bit samples. This indicates that built-in hardware necessary to handle 16-bit data is available.

gestaltStereoInput

Set if the built-in sound hardware can record stereo sounds.

gestaltLineLevelInput

Set if the built-in sound input port requires line level input.

gestaltSndPlayDoubleBuffer

Set if the Sound Manager supports the play-from-disk routines.

gestaltMultiChannels

Set if the Sound Manager supports multiple channels of sound.

gestalt16BitAudioSupport

Set if the Sound Manager can handle 16-bit audio data. This indicates that software necessary to handle 16-bit data is available.

Note

For complete information about the Gestalt function, see the chapter "Gestalt Manager" in Inside Macintosh: Operating System Utilities.