Mac OS 9
Sound.h File Reference

Sound Manager Interfaces. More...

#include <MacTypes.h>
#include <Components.h>
#include <MixedMode.h>
#include <Dialogs.h>

Go to the source code of this file.

Data Structures

struct  SndCommand
 
struct  SndChannel
 
struct  StateBlock
 
struct  LeftOverBlock
 
struct  ModRef
 
struct  SndListResource
 
struct  Snd2ListResource
 
struct  SoundHeader
 
struct  CmpSoundHeader
 
struct  ExtSoundHeader
 
union  SoundHeaderUnion
 
struct  ConversionBlock
 
struct  ScheduledSoundHeader
 
struct  ExtendedScheduledSoundHeader
 
struct  SMStatus
 
struct  SCStatus
 
struct  AudioSelection
 
struct  SndDoubleBuffer
 
struct  SndDoubleBufferHeader
 
struct  SndDoubleBufferHeader2
 
struct  SoundInfoList
 
struct  SoundComponentData
 
struct  ExtendedSoundComponentData
 
struct  SoundParamBlock
 
struct  ExtendedSoundParamBlock
 
struct  CompressionInfo
 
struct  SoundSlopeAndInterceptRecord
 
struct  SoundComponentLink
 
struct  AudioInfo
 
struct  AudioFormatAtom
 
struct  AudioEndianAtom
 
struct  AudioTerminatorAtom
 
struct  LevelMeterInfo
 
struct  EQSpectrumBandsRecord
 
struct  SPB
 
struct  SndInputCmpParam
 

Macros

#define twelfthRootTwo   1.05946309435
 
#define NewSndCallBackUPP(userRoutine)
 
#define DisposeSndCallBackUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define InvokeSndCallBackUPP(chan, cmd, userUPP)    CALL_TWO_PARAMETER_UPP((userUPP), uppSndCallBackProcInfo, (chan), (cmd))
 
#define NewSndCallBackProc(userRoutine)   NewSndCallBackUPP(userRoutine)
 
#define CallSndCallBackProc(userRoutine, chan, cmd)    InvokeSndCallBackUPP(chan, cmd, userRoutine)
 
#define NewSndDoubleBackUPP(userRoutine)
 
#define DisposeSndDoubleBackUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define InvokeSndDoubleBackUPP(channel, doubleBufferPtr, userUPP)
 
#define NewSndDoubleBackProc(userRoutine)   NewSndDoubleBackUPP(userRoutine)
 
#define CallSndDoubleBackProc(userRoutine, channel, doubleBufferPtr)    InvokeSndDoubleBackUPP(channel, doubleBufferPtr, userRoutine)
 
#define NewSoundParamUPP(userRoutine)
 
#define NewSoundConverterFillBufferDataUPP(userRoutine)
 
#define NewSIInterruptUPP(userRoutine)
 
#define NewSICompletionUPP(userRoutine)
 
#define DisposeSoundParamUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define DisposeSoundConverterFillBufferDataUPP(userUPP)    DisposeRoutineDescriptor(userUPP)
 
#define DisposeSIInterruptUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define DisposeSICompletionUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define InvokeSoundParamUPP(pb, userUPP)    (Boolean) CALL_ONE_PARAMETER_UPP((userUPP), uppSoundParamProcInfo, (pb))
 
#define InvokeSoundConverterFillBufferDataUPP(data, refCon, userUPP)
 
#define InvokeSIInterruptUPP(inParamPtr, dataBuffer, peakAmplitude, sampleSize, userUPP)
 
#define InvokeSICompletionUPP(inParamPtr, userUPP)    CALL_ONE_PARAMETER_UPP((userUPP), uppSICompletionProcInfo, (inParamPtr))
 
#define NewSoundParamProc(userRoutine)   NewSoundParamUPP(userRoutine)
 
#define NewSoundConverterFillBufferDataProc(userRoutine)    NewSoundConverterFillBufferDataUPP(userRoutine)
 
#define NewSIInterruptProc(userRoutine)   NewSIInterruptUPP(userRoutine)
 
#define NewSICompletionProc(userRoutine)   NewSICompletionUPP(userRoutine)
 
#define CallSoundParamProc(userRoutine, pb)   InvokeSoundParamUPP(pb, userRoutine)
 
#define CallSoundConverterFillBufferDataProc(userRoutine, data, refCon)    InvokeSoundConverterFillBufferDataUPP(data, refCon, userRoutine)
 
#define CallSIInterruptProc(userRoutine, inParamPtr, dataBuffer, peakAmplitude, sampleSize)
 
#define CallSICompletionProc(userRoutine, inParamPtr)    InvokeSICompletionUPP(inParamPtr, userRoutine)
 
#define NewFilePlayCompletionUPP(userRoutine)
 
#define DisposeFilePlayCompletionUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define InvokeFilePlayCompletionUPP(chan, userUPP)    CALL_ONE_PARAMETER_UPP((userUPP), uppFilePlayCompletionProcInfo, (chan))
 
#define NewFilePlayCompletionProc(userRoutine)    NewFilePlayCompletionUPP(userRoutine)
 
#define CallFilePlayCompletionProc(userRoutine, chan)    InvokeFilePlayCompletionUPP(chan, userRoutine)
 

Typedefs

typedef struct SndCommand SndCommand
 
typedef struct SndChannel SndChannel
 
typedef SndChannelSndChannelPtr
 
typedef SndCommandcmd
 
typedef struct StateBlock StateBlock
 
typedef StateBlockStateBlockPtr
 
typedef struct LeftOverBlock LeftOverBlock
 
typedef LeftOverBlockLeftOverBlockPtr
 
typedef struct ModRef ModRef
 
typedef struct SndListResource SndListResource
 
typedef SndListResourceSndListPtr
 
typedef SndListPtrSndListHandle
 
typedef SndListHandle SndListHndl
 
typedef struct Snd2ListResource Snd2ListResource
 
typedef Snd2ListResourceSnd2ListPtr
 
typedef Snd2ListPtrSnd2ListHandle
 
typedef Snd2ListHandle Snd2ListHndl
 
typedef struct SoundHeader SoundHeader
 
typedef SoundHeaderSoundHeaderPtr
 
typedef struct CmpSoundHeader CmpSoundHeader
 
typedef CmpSoundHeaderCmpSoundHeaderPtr
 
typedef struct ExtSoundHeader ExtSoundHeader
 
typedef ExtSoundHeaderExtSoundHeaderPtr
 
typedef union SoundHeaderUnion SoundHeaderUnion
 
typedef struct ConversionBlock ConversionBlock
 
typedef ConversionBlockConversionBlockPtr
 
typedef struct ScheduledSoundHeader ScheduledSoundHeader
 
typedef ScheduledSoundHeaderScheduledSoundHeaderPtr
 
typedef struct ExtendedScheduledSoundHeader ExtendedScheduledSoundHeader
 
typedef ExtendedScheduledSoundHeaderExtendedScheduledSoundHeaderPtr
 
typedef struct SMStatus SMStatus
 
typedef SMStatusSMStatusPtr
 
typedef struct SCStatus SCStatus
 
typedef SCStatusSCStatusPtr
 
typedef struct AudioSelection AudioSelection
 
typedef AudioSelectionAudioSelectionPtr
 
typedef struct SndDoubleBuffer SndDoubleBuffer
 
typedef SndDoubleBufferSndDoubleBufferPtr
 
typedef SndDoubleBufferPtr doubleBufferPtr
 
typedef struct SndDoubleBufferHeader SndDoubleBufferHeader
 
typedef SndDoubleBufferHeaderSndDoubleBufferHeaderPtr
 
typedef struct SndDoubleBufferHeader2 SndDoubleBufferHeader2
 
typedef SndDoubleBufferHeader2SndDoubleBufferHeader2Ptr
 
typedef struct SoundInfoList SoundInfoList
 
typedef SoundInfoListSoundInfoListPtr
 
typedef struct SoundComponentData SoundComponentData
 
typedef SoundComponentDataSoundComponentDataPtr
 
typedef struct ExtendedSoundComponentData ExtendedSoundComponentData
 
typedef ExtendedSoundComponentDataExtendedSoundComponentDataPtr
 
typedef struct SoundParamBlock SoundParamBlock
 
typedef SoundParamBlockSoundParamBlockPtr
 
typedef struct ExtendedSoundParamBlock ExtendedSoundParamBlock
 
typedef ExtendedSoundParamBlockExtendedSoundParamBlockPtr
 
typedef struct CompressionInfo CompressionInfo
 
typedef CompressionInfoCompressionInfoPtr
 
typedef CompressionInfoPtrCompressionInfoHandle
 
typedef struct SoundSlopeAndInterceptRecord SoundSlopeAndInterceptRecord
 
typedef SoundSlopeAndInterceptRecordSoundSlopeAndInterceptPtr
 
typedef struct OpaqueSoundConverter * SoundConverter
 
typedef void * refCon
 
typedef struct OpaqueSoundSource * SoundSource
 
typedef SoundSourceSoundSourcePtr
 
typedef struct SoundComponentLink SoundComponentLink
 
typedef SoundComponentLinkSoundComponentLinkPtr
 
typedef struct AudioInfo AudioInfo
 
typedef AudioInfoAudioInfoPtr
 
typedef struct AudioFormatAtom AudioFormatAtom
 
typedef AudioFormatAtomAudioFormatAtomPtr
 
typedef struct AudioEndianAtom AudioEndianAtom
 
typedef AudioEndianAtomAudioEndianAtomPtr
 
typedef struct AudioTerminatorAtom AudioTerminatorAtom
 
typedef AudioTerminatorAtomAudioTerminatorAtomPtr
 
typedef struct LevelMeterInfo LevelMeterInfo
 
typedef LevelMeterInfoLevelMeterInfoPtr
 
typedef struct EQSpectrumBandsRecord EQSpectrumBandsRecord
 
typedef EQSpectrumBandsRecordEQSpectrumBandsRecordPtr
 
typedef struct SPB SPB
 
typedef SPBSPBPtr
 
typedef struct SndInputCmpParam SndInputCmpParam
 
typedef SndInputCmpParamSndInputCmpParamPtr
 

Enumerations

enum  { soundListRsrc }
 
enum  { kSimpleBeepID = 1 }
 
enum  {
  rate48khz = (long)0xBB800000 , rate44khz = (long)0xAC440000 , rate32khz = 0x7D000000 , rate22050hz = 0x56220000 ,
  rate22khz = 0x56EE8BA3 , rate16khz = 0x3E800000 , rate11khz = 0x2B7745D1 , rate11025hz = 0x2B110000 ,
  rate8khz = 0x1F400000
}
 
enum  { sampledSynth = 5 }
 
enum  { squareWaveSynth = 1 , waveTableSynth = 3 , MACE3snthID = 11 , MACE6snthID = 13 }
 
enum  { kMiddleC = 60 }
 
enum  { kNoVolume = 0 , kFullVolume = 0x0100 }
 
enum  { stdQLength = 128 }
 
enum  { dataOffsetFlag = 0x8000 }
 
enum  { kUseOptionalOutputDevice = -1 }
 
enum  { notCompressed = 0 , fixedCompression = -1 , variableCompression = -2 }
 
enum  {
  twoToOne = 1 , eightToThree = 2 , threeToOne = 3 , sixToOne = 4 ,
  sixToOnePacketSize = 8 , threeToOnePacketSize = 16
}
 
enum  { stateBlockSize = 64 , leftOverBlockSize = 32 }
 
enum  { firstSoundFormat = 0x0001 , secondSoundFormat = 0x0002 }
 
enum  { dbBufferReady = 0x00000001 , dbLastBuffer = 0x00000004 }
 
enum  { sysBeepDisable = 0x0000 , sysBeepEnable = (1 << 0) , sysBeepSynchronous = (1 << 1) }
 
enum  { unitTypeNoSelection = 0xFFFF , unitTypeSeconds = 0x0000 }
 
enum  { stdSH = 0x00 , extSH = 0xFF , cmpSH = 0xFE }
 
enum  {
  nullCmd = 0 , quietCmd = 3 , flushCmd = 4 , reInitCmd = 5 ,
  waitCmd = 10 , pauseCmd = 11 , resumeCmd = 12 , callBackCmd = 13 ,
  syncCmd = 14 , availableCmd = 24 , versionCmd = 25 , volumeCmd = 46 ,
  getVolumeCmd = 47 , clockComponentCmd = 50 , getClockComponentCmd = 51 , scheduledSoundCmd = 52 ,
  linkSoundComponentsCmd = 53 , soundCmd = 80 , bufferCmd = 81 , rateMultiplierCmd = 86 ,
  getRateMultiplierCmd = 87
}
 
enum  {
  initCmd = 1 , freeCmd = 2 , totalLoadCmd = 26 , loadCmd = 27 ,
  freqDurationCmd = 40 , restCmd = 41 , freqCmd = 42 , ampCmd = 43 ,
  timbreCmd = 44 , getAmpCmd = 45 , waveTableCmd = 60 , phaseCmd = 61 ,
  rateCmd = 82 , continueCmd = 83 , doubleBufferCmd = 84 , getRateCmd = 85 ,
  sizeCmd = 90 , convertCmd = 91
}
 
enum  {
  initChanLeft = 0x0002 , initChanRight = 0x0003 , initNoInterp = 0x0004 , initNoDrop = 0x0008 ,
  initMono = 0x0080 , initStereo = 0x00C0 , initMACE3 = 0x0300 , initMACE6 = 0x0400 ,
  initPanMask = 0x0003 , initSRateMask = 0x0030 , initStereoMask = 0x00C0 , initCompMask = 0xFF00
}
 
enum  {
  siActiveChannels = FOUR_CHAR_CODE('chac') , siActiveLevels = FOUR_CHAR_CODE('lmac') , siAGCOnOff = FOUR_CHAR_CODE('agc ') , siAsync = FOUR_CHAR_CODE('asyn') ,
  siAVDisplayBehavior = FOUR_CHAR_CODE('avdb') , siChannelAvailable = FOUR_CHAR_CODE('chav') , siCompressionAvailable , siCompressionChannels ,
  siCompressionFactor = FOUR_CHAR_CODE('cmfa') , siCompressionHeader = FOUR_CHAR_CODE('cmhd') , siCompressionNames , siCompressionParams = FOUR_CHAR_CODE('evaw') ,
  siCompressionSampleRate , siCompressionType = FOUR_CHAR_CODE('comp') , siContinuous = FOUR_CHAR_CODE('cont') , siDecompressionParams = FOUR_CHAR_CODE('wave') ,
  siDeviceBufferInfo = FOUR_CHAR_CODE('dbin') , siDeviceConnected , siDeviceIcon = FOUR_CHAR_CODE('icon') , siDeviceName = FOUR_CHAR_CODE('name') ,
  siEQSpectrumBands = FOUR_CHAR_CODE('eqsb') , siEQSpectrumLevels = FOUR_CHAR_CODE('eqlv') , siEQSpectrumOnOff , siEQSpectrumResolution ,
  siEQToneControlGain , siEQToneControlOnOff , siHardwareBalance = FOUR_CHAR_CODE('hbal') , siHardwareBalanceSteps = FOUR_CHAR_CODE('hbls') ,
  siHardwareBass = FOUR_CHAR_CODE('hbas') , siHardwareBassSteps = FOUR_CHAR_CODE('hbst') , siHardwareBusy = FOUR_CHAR_CODE('hwbs') , siHardwareFormat = FOUR_CHAR_CODE('hwfm') ,
  siHardwareMute = FOUR_CHAR_CODE('hmut') , siHardwareMuteNoPrefs , siHardwareTreble = FOUR_CHAR_CODE('htrb') , siHardwareTrebleSteps = FOUR_CHAR_CODE('hwts') ,
  siHardwareVolume = FOUR_CHAR_CODE('hvol') , siHardwareVolumeSteps , siHeadphoneMute = FOUR_CHAR_CODE('pmut') , siHeadphoneVolume = FOUR_CHAR_CODE('pvol') ,
  siHeadphoneVolumeSteps , siInputAvailable = FOUR_CHAR_CODE('inav') , siInputGain = FOUR_CHAR_CODE('gain') , siInputSource = FOUR_CHAR_CODE('sour') ,
  siInputSourceNames = FOUR_CHAR_CODE('snam') , siLevelMeterOnOff = FOUR_CHAR_CODE('lmet') , siModemGain = FOUR_CHAR_CODE('mgai') , siMonitorAvailable = FOUR_CHAR_CODE('mnav') ,
  siMonitorSource = FOUR_CHAR_CODE('mons') , siNumberChannels = FOUR_CHAR_CODE('chan') , siOptionsDialog = FOUR_CHAR_CODE('optd') , siOSTypeInputSource = FOUR_CHAR_CODE('inpt') ,
  siOSTypeInputAvailable , siOutputDeviceName = FOUR_CHAR_CODE('onam') , siPlayThruOnOff = FOUR_CHAR_CODE('plth') , siPostMixerSoundComponent ,
  siPreMixerSoundComponent , siQuality = FOUR_CHAR_CODE('qual') , siRateMultiplier = FOUR_CHAR_CODE('rmul') , siRecordingQuality = FOUR_CHAR_CODE('qual') ,
  siSampleRate = FOUR_CHAR_CODE('srat') , siSampleRateAvailable = FOUR_CHAR_CODE('srav') , siSampleSize = FOUR_CHAR_CODE('ssiz') , siSampleSizeAvailable = FOUR_CHAR_CODE('ssav') ,
  siSetupCDAudio , siSetupModemAudio , siSlopeAndIntercept , siSoundClock = FOUR_CHAR_CODE('sclk') ,
  siUseThisSoundClock , siSpeakerMute , siSpeakerVolume , siSSpCPULoadLimit = FOUR_CHAR_CODE('3dll') ,
  siSSpLocalization = FOUR_CHAR_CODE('3dif') , siSSpSpeakerSetup = FOUR_CHAR_CODE('3dst') , siStereoInputGain = FOUR_CHAR_CODE('sgai') , siSubwooferMute = FOUR_CHAR_CODE('bmut') ,
  siTerminalType = FOUR_CHAR_CODE('ttyp') , siTwosComplementOnOff = FOUR_CHAR_CODE('twos') , siVendorProduct = FOUR_CHAR_CODE('vpro') , siVolume = FOUR_CHAR_CODE('volu') ,
  siVoxRecordInfo = FOUR_CHAR_CODE('voxr') , siVoxStopInfo = FOUR_CHAR_CODE('voxs') , siWideStereo = FOUR_CHAR_CODE('wide') , siSupportedExtendedFlags ,
  siRateConverterRollOffSlope , siOutputLatency
}
 
enum  { siCloseDriver = FOUR_CHAR_CODE('clos') , siInitializeDriver , siPauseRecording = FOUR_CHAR_CODE('paus') , siUserInterruptProc }
 
enum  {
  kInvalidSource , kNoSource = FOUR_CHAR_CODE('none') , kCDSource = FOUR_CHAR_CODE('cd ') , kExtMicSource = FOUR_CHAR_CODE('emic') ,
  kSoundInSource = FOUR_CHAR_CODE('sinj') , kRCAInSource = FOUR_CHAR_CODE('irca') , kTVFMTunerSource = FOUR_CHAR_CODE('tvfm') , kDAVInSource = FOUR_CHAR_CODE('idav') ,
  kIntMicSource = FOUR_CHAR_CODE('imic') , kMediaBaySource = FOUR_CHAR_CODE('mbay') , kModemSource = FOUR_CHAR_CODE('modm') , kPCCardSource = FOUR_CHAR_CODE('pcm ') ,
  kZoomVideoSource = FOUR_CHAR_CODE('zvpc') , kDVDSource = FOUR_CHAR_CODE('dvda') , kMicrophoneArray = FOUR_CHAR_CODE('mica')
}
 
enum  {
  kNoSoundComponentType = FOUR_CHAR_CODE('****') , kSoundComponentType = FOUR_CHAR_CODE('sift') , kSoundComponentPPCType , kRate8SubType = FOUR_CHAR_CODE('ratb') ,
  kRate16SubType = FOUR_CHAR_CODE('ratw') , kConverterSubType = FOUR_CHAR_CODE('conv') , kSndSourceSubType = FOUR_CHAR_CODE('sour') , kMixerType = FOUR_CHAR_CODE('mixr') ,
  kMixer8SubType = FOUR_CHAR_CODE('mixb') , kMixer16SubType = FOUR_CHAR_CODE('mixw') , kSoundInputDeviceType = FOUR_CHAR_CODE('sinp') , kWaveInSubType = FOUR_CHAR_CODE('wavi') ,
  kWaveInSnifferSubType = FOUR_CHAR_CODE('wisn') , kSoundOutputDeviceType = FOUR_CHAR_CODE('sdev') , kClassicSubType = FOUR_CHAR_CODE('clas') , kASCSubType = FOUR_CHAR_CODE('asc ') ,
  kDSPSubType = FOUR_CHAR_CODE('dsp ') , kAwacsSubType , kGCAwacsSubType , kSingerSubType = FOUR_CHAR_CODE('sing') ,
  kSinger2SubType = FOUR_CHAR_CODE('sng2') , kWhitSubType , kSoundBlasterSubType = FOUR_CHAR_CODE('sbls') , kWaveOutSubType = FOUR_CHAR_CODE('wavo') ,
  kWaveOutSnifferSubType = FOUR_CHAR_CODE('wosn') , kDirectSoundSubType = FOUR_CHAR_CODE('dsnd') , kDirectSoundSnifferSubType , kUNIXsdevSubType = FOUR_CHAR_CODE('un1x') ,
  kUSBSubType = FOUR_CHAR_CODE('usb ') , kBlueBoxSubType = FOUR_CHAR_CODE('bsnd') , kSoundCompressor = FOUR_CHAR_CODE('scom') , kSoundDecompressor = FOUR_CHAR_CODE('sdec') ,
  kAudioComponentType , kAwacsPhoneSubType = FOUR_CHAR_CODE('hphn') , kAudioVisionSpeakerSubType = FOUR_CHAR_CODE('telc') , kAudioVisionHeadphoneSubType = FOUR_CHAR_CODE('telh') ,
  kPhilipsFaderSubType = FOUR_CHAR_CODE('tvav') , kSGSToneSubType = FOUR_CHAR_CODE('sgs0') , kSoundEffectsType = FOUR_CHAR_CODE('snfx') , kEqualizerSubType = FOUR_CHAR_CODE('eqal') ,
  kSSpLocalizationSubType = FOUR_CHAR_CODE('snd3')
}
 
enum  {
  kSoundNotCompressed = FOUR_CHAR_CODE('NONE') , k8BitOffsetBinaryFormat = FOUR_CHAR_CODE('raw ') , k16BitBigEndianFormat = FOUR_CHAR_CODE('twos') , k16BitLittleEndianFormat = FOUR_CHAR_CODE('sowt') ,
  kFloat32Format = FOUR_CHAR_CODE('fl32') , kFloat64Format = FOUR_CHAR_CODE('fl64') , k24BitFormat = FOUR_CHAR_CODE('in24') , k32BitFormat = FOUR_CHAR_CODE('in32') ,
  k32BitLittleEndianFormat , kMACE3Compression = FOUR_CHAR_CODE('MAC3') , kMACE6Compression = FOUR_CHAR_CODE('MAC6') , kCDXA4Compression = FOUR_CHAR_CODE('cdx4') ,
  kCDXA2Compression = FOUR_CHAR_CODE('cdx2') , kIMACompression = FOUR_CHAR_CODE('ima4') , kULawCompression = FOUR_CHAR_CODE('ulaw') , kALawCompression = FOUR_CHAR_CODE('alaw') ,
  kMicrosoftADPCMFormat = 0x6D730002 , kDVIIntelIMAFormat = 0x6D730011 , kDVAudioFormat = FOUR_CHAR_CODE('dvca') , kQDesignCompression = FOUR_CHAR_CODE('QDMC') ,
  kQDesign2Compression = FOUR_CHAR_CODE('QDM2') , kQUALCOMMCompression = FOUR_CHAR_CODE('Qclp') , kOffsetBinary = k8BitOffsetBinaryFormat , kTwosComplement = k16BitBigEndianFormat ,
  kLittleEndianFormat = k16BitLittleEndianFormat , kMPEGLayer3Format = 0x6D730055 , kFullMPEGLay3Format
}
 
enum  { k16BitNativeEndianFormat = k16BitBigEndianFormat , k16BitNonNativeEndianFormat = k16BitLittleEndianFormat }
 
enum  {
  k8BitRawIn = (1 << 0) , k8BitTwosIn = (1 << 1) , k16BitIn = (1 << 2) , kStereoIn = (1 << 3) ,
  k8BitRawOut = (1 << 8) , k8BitTwosOut = (1 << 9) , k16BitOut = (1 << 10) , kStereoOut = (1 << 11) ,
  kReverse = (1L << 16) , kRateConvert = (1L << 17) , kCreateSoundSource = (1L << 18) , kVMAwareness = (1L << 21) ,
  kHighQuality = (1L << 22) , kNonRealTime = (1L << 23)
}
 
enum  { kSourcePaused = (1 << 0) , kPassThrough = (1L << 16) , kNoSoundComponentChain = (1L << 17) }
 
enum  {
  kNoMixing = (1 << 0) , kNoSampleRateConversion , kNoSampleSizeConversion , kNoSampleFormatConversion ,
  kNoChannelConversion = (1 << 4) , kNoDecompression = (1 << 5) , kNoVolumeConversion = (1 << 6) , kNoRealtimeProcessing = (1 << 7) ,
  kScheduledSource = (1 << 8) , kNonInterleavedBuffer = (1 << 9) , kNonPagingMixer = (1 << 10) , kSoundConverterMixer ,
  kPagingMixer , kVMAwareMixer = (1 << 13) , kExtendedSoundData = (1 << 14)
}
 
enum  { kBestQuality = (1 << 0) }
 
enum  {
  kInputMask = 0x000000FF , kOutputMask = 0x0000FF00 , kOutputShift = 8 , kActionMask = 0x00FF0000 ,
  kSoundComponentBits = 0x00FFFFFF
}
 
enum  { kAudioFormatAtomType = FOUR_CHAR_CODE('frma') , kAudioEndianAtomType = FOUR_CHAR_CODE('enda') , kAudioVBRAtomType = FOUR_CHAR_CODE('vbra') , kAudioTerminatorAtomType = 0 }
 
enum  { kAVDisplayHeadphoneRemove , kAVDisplayHeadphoneInsert = 1 , kAVDisplayPlainTalkRemove , kAVDisplayPlainTalkInsert = 3 }
 
enum  {
  audioAllChannels , audioLeftChannel = 1 , audioRightChannel = 2 , audioUnmuted = 0 ,
  audioMuted = 1 , audioDoesMono = (1L << 0) , audioDoesStereo = (1L << 1) , audioDoesIndependentChannels
}
 
enum  {
  siCDQuality = FOUR_CHAR_CODE('cd ') , siBestQuality = FOUR_CHAR_CODE('best') , siBetterQuality = FOUR_CHAR_CODE('betr') , siGoodQuality = FOUR_CHAR_CODE('good') ,
  siNoneQuality
}
 
enum  {
  siDeviceIsConnected = 1 , siDeviceNotConnected = 0 , siDontKnowIfConnected = -1 , siReadPermission = 0 ,
  siWritePermission = 1
}
 
enum  { kSoundConverterDidntFillBuffer , kSoundConverterHasLeftOverData }
 
enum  { kExtendedSoundSampleCountNotValid , kExtendedSoundBufferSizeValid = 1L << 1 }
 
enum  { uppSndCallBackProcInfo = 0x000003C0 }
 
enum  { kScheduledSoundDoScheduled = 1 << 0 , kScheduledSoundDoCallBack = 1 << 1 , kScheduledSoundExtendedHdr = 1 << 2 }
 
enum  { uppSndDoubleBackProcInfo = 0x000003C0 }
 
enum  { uppSoundParamProcInfo = 0x000000D0 }
 
enum  { uppSoundConverterFillBufferDataProcInfo = 0x000003D0 }
 
enum  { uppSIInterruptProcInfo = 0x1C579802 }
 
enum  { uppSICompletionProcInfo = 0x000000C0 }
 
enum  { uppFilePlayCompletionProcInfo = 0x000000C0 }
 
enum  {
  kSoundComponentInitOutputDeviceSelect = 0x0001 , kSoundComponentSetSourceSelect = 0x0002 , kSoundComponentGetSourceSelect = 0x0003 , kSoundComponentGetSourceDataSelect = 0x0004 ,
  kSoundComponentSetOutputSelect = 0x0005 , kSoundComponentAddSourceSelect = 0x0101 , kSoundComponentRemoveSourceSelect = 0x0102 , kSoundComponentGetInfoSelect = 0x0103 ,
  kSoundComponentSetInfoSelect = 0x0104 , kSoundComponentStartSourceSelect = 0x0105 , kSoundComponentStopSourceSelect = 0x0106 , kSoundComponentPauseSourceSelect = 0x0107 ,
  kSoundComponentPlaySourceBufferSelect = 0x0108
}
 
enum  {
  kAudioGetVolumeSelect = 0x0000 , kAudioSetVolumeSelect = 0x0001 , kAudioGetMuteSelect = 0x0002 , kAudioSetMuteSelect = 0x0003 ,
  kAudioSetToDefaultsSelect = 0x0004 , kAudioGetInfoSelect = 0x0005 , kAudioGetBassSelect = 0x0006 , kAudioSetBassSelect = 0x0007 ,
  kAudioGetTrebleSelect = 0x0008 , kAudioSetTrebleSelect = 0x0009 , kAudioGetOutputDeviceSelect = 0x000A , kAudioMuteOnEventSelect = 0x0081
}
 
enum  { kDelegatedSoundComponentSelectors = 0x0100 }
 
enum  {
  kSndInputReadAsyncSelect = 0x0001 , kSndInputReadSyncSelect = 0x0002 , kSndInputPauseRecordingSelect = 0x0003 , kSndInputResumeRecordingSelect = 0x0004 ,
  kSndInputStopRecordingSelect = 0x0005 , kSndInputGetStatusSelect = 0x0006 , kSndInputGetDeviceInfoSelect = 0x0007 , kSndInputSetDeviceInfoSelect = 0x0008 ,
  kSndInputInitHardwareSelect = 0x0009
}
 
enum  {
  kSndInputReadAsyncSelect = 0x0001 , kSndInputReadSyncSelect = 0x0002 , kSndInputPauseRecordingSelect = 0x0003 , kSndInputResumeRecordingSelect = 0x0004 ,
  kSndInputStopRecordingSelect = 0x0005 , kSndInputGetStatusSelect = 0x0006 , kSndInputGetDeviceInfoSelect = 0x0007 , kSndInputSetDeviceInfoSelect = 0x0008 ,
  kSndInputInitHardwareSelect = 0x0009
}
 

Functions

typedef CALLBACK_API (void, SndCallBackProcPtr)(SndChannelPtr chan
 
typedef STACK_UPP_TYPE (SndCallBackProcPtr) SndCallBackUPP
 
SndCallBackUPP NewSndCallBackUPP (SndCallBackProcPtr userRoutine)
 
void DisposeSndCallBackUPP (SndCallBackUPP userUPP)
 
void InvokeSndCallBackUPP (SndChannelPtr chan, SndCommand *cmd, SndCallBackUPP userUPP)
 
typedef CALLBACK_API (void, SndDoubleBackProcPtr)(SndChannelPtr channel
 
typedef STACK_UPP_TYPE (SndDoubleBackProcPtr) SndDoubleBackUPP
 
SndDoubleBackUPP NewSndDoubleBackUPP (SndDoubleBackProcPtr userRoutine)
 
void DisposeSndDoubleBackUPP (SndDoubleBackUPP userUPP)
 
void InvokeSndDoubleBackUPP (SndChannelPtr channel, SndDoubleBufferPtr doubleBufferPtr, SndDoubleBackUPP userUPP)
 
typedef CALLBACK_API (Boolean, SoundParamProcPtr)(SoundParamBlockPtr *pb)
 
typedef STACK_UPP_TYPE (SoundParamProcPtr) SoundParamUPP
 
typedef CALLBACK_API (Boolean, SoundConverterFillBufferDataProcPtr)(SoundComponentDataPtr *data
 
typedef STACK_UPP_TYPE (SoundConverterFillBufferDataProcPtr) SoundConverterFillBufferDataUPP
 
typedef CALLBACK_API_REGISTER68K (void, SIInterruptProcPtr,(SPBPtr inParamPtr, Ptr dataBuffer, short peakAmplitude, long sampleSize))
 
typedef CALLBACK_API (void, SICompletionProcPtr)(SPBPtr inParamPtr)
 
typedef REGISTER_UPP_TYPE (SIInterruptProcPtr) SIInterruptUPP
 
typedef STACK_UPP_TYPE (SICompletionProcPtr) SICompletionUPP
 
SoundParamUPP NewSoundParamUPP (SoundParamProcPtr userRoutine)
 
SoundConverterFillBufferDataUPP NewSoundConverterFillBufferDataUPP (SoundConverterFillBufferDataProcPtr userRoutine)
 
SIInterruptUPP NewSIInterruptUPP (SIInterruptProcPtr userRoutine)
 
SICompletionUPP NewSICompletionUPP (SICompletionProcPtr userRoutine)
 
void DisposeSoundParamUPP (SoundParamUPP userUPP)
 
void DisposeSoundConverterFillBufferDataUPP (SoundConverterFillBufferDataUPP userUPP)
 
void DisposeSIInterruptUPP (SIInterruptUPP userUPP)
 
void DisposeSICompletionUPP (SICompletionUPP userUPP)
 
Boolean InvokeSoundParamUPP (SoundParamBlockPtr *pb, SoundParamUPP userUPP)
 
Boolean InvokeSoundConverterFillBufferDataUPP (SoundComponentDataPtr *data, void *refCon, SoundConverterFillBufferDataUPP userUPP)
 
void InvokeSIInterruptUPP (SPBPtr inParamPtr, Ptr dataBuffer, short peakAmplitude, long sampleSize, SIInterruptUPP userUPP)
 
void InvokeSICompletionUPP (SPBPtr inParamPtr, SICompletionUPP userUPP)
 
typedef CALLBACK_API (void, FilePlayCompletionProcPtr)(SndChannelPtr chan)
 
typedef STACK_UPP_TYPE (FilePlayCompletionProcPtr) FilePlayCompletionUPP
 
FilePlayCompletionUPP NewFilePlayCompletionUPP (FilePlayCompletionProcPtr userRoutine)
 
void DisposeFilePlayCompletionUPP (FilePlayCompletionUPP userUPP)
 
void InvokeFilePlayCompletionUPP (SndChannelPtr chan, FilePlayCompletionUPP userUPP)
 
void SysBeep (short duration)
 
OSErr SndDoCommand (SndChannelPtr chan, const SndCommand *cmd, Boolean noWait)
 
OSErr SndDoImmediate (SndChannelPtr chan, const SndCommand *cmd)
 
OSErr SndNewChannel (SndChannelPtr *chan, short synth, long init, SndCallBackUPP userRoutine)
 
OSErr SndDisposeChannel (SndChannelPtr chan, Boolean quietNow)
 
OSErr SndPlay (SndChannelPtr chan, SndListHandle sndHandle, Boolean async)
 
OSErr SndControl (short id, SndCommand *cmd)
 
NumVersion SndSoundManagerVersion (void)
 SndSoundManagerVersion Determine the version of the Sound Manager. More...
 
OSErr SndStartFilePlay (SndChannelPtr chan, short fRefNum, short resNum, long bufferSize, void *theBuffer, AudioSelectionPtr theSelection, FilePlayCompletionUPP theCompletion, Boolean async)
 
OSErr SndPauseFilePlay (SndChannelPtr chan)
 SndPauseFilePlay Suspend asynchronous play from disk. More...
 
OSErr SndStopFilePlay (SndChannelPtr chan, Boolean quietNow)
 
OSErr SndChannelStatus (SndChannelPtr chan, short theLength, SCStatusPtr theStatus)
 
OSErr SndManagerStatus (short theLength, SMStatusPtr theStatus)
 SndManagerStatus Determine information about the Sound Manager. More...
 
void SndGetSysBeepState (short *sysBeepState)
 SndGetSysBeepState Determine whether SysBeep is enabled. More...
 
OSErr SndSetSysBeepState (short sysBeepState)
 SndSetSysBeepState Set the state of the system alert sound.. More...
 
OSErr SndPlayDoubleBuffer (SndChannelPtr chan, SndDoubleBufferHeaderPtr theParams)
 
NumVersion MACEVersion (void)
 Determine the version of the MACE tools. More...
 
void Comp3to1 (const void *inBuffer, void *outBuffer, unsigned long cnt, StateBlockPtr inState, StateBlockPtr outState, unsigned long numChannels, unsigned long whichChannel)
 
void Exp1to3 (const void *inBuffer, void *outBuffer, unsigned long cnt, StateBlockPtr inState, StateBlockPtr outState, unsigned long numChannels, unsigned long whichChannel)
 
void Comp6to1 (const void *inBuffer, void *outBuffer, unsigned long cnt, StateBlockPtr inState, StateBlockPtr outState, unsigned long numChannels, unsigned long whichChannel)
 
void Exp1to6 (const void *inBuffer, void *outBuffer, unsigned long cnt, StateBlockPtr inState, StateBlockPtr outState, unsigned long numChannels, unsigned long whichChannel)
 
OSErr GetSysBeepVolume (long *level)
 
OSErr SetSysBeepVolume (long level)
 
OSErr GetDefaultOutputVolume (long *level)
 
OSErr SetDefaultOutputVolume (long level)
 
OSErr GetSoundHeaderOffset (SndListHandle sndHandle, long *offset)
 
UnsignedFixed UnsignedFixedMulDiv (UnsignedFixed value, UnsignedFixed multiplier, UnsignedFixed divisor)
 
OSErr GetCompressionInfo (short compressionID, OSType format, short numChannels, short sampleSize, CompressionInfoPtr cp)
 
OSErr SetSoundPreference (OSType theType, Str255 name, Handle settings)
 
OSErr GetSoundPreference (OSType theType, Str255 name, Handle settings)
 
OSErr OpenMixerSoundComponent (SoundComponentDataPtr outputDescription, long outputFlags, ComponentInstance *mixerComponent)
 
OSErr CloseMixerSoundComponent (ComponentInstance ci)
 
OSErr SndGetInfo (SndChannelPtr chan, OSType selector, void *infoPtr)
 
OSErr SndSetInfo (SndChannelPtr chan, OSType selector, const void *infoPtr)
 
OSErr GetSoundOutputInfo (Component outputDevice, OSType selector, void *infoPtr)
 
OSErr SetSoundOutputInfo (Component outputDevice, OSType selector, const void *infoPtr)
 
OSErr GetCompressionName (OSType compressionType, Str255 compressionName)
 
OSErr SoundConverterOpen (const SoundComponentData *inputFormat, const SoundComponentData *outputFormat, SoundConverter *sc)
 
OSErr SoundConverterClose (SoundConverter sc)
 
OSErr SoundConverterGetBufferSizes (SoundConverter sc, unsigned long inputBytesTarget, unsigned long *inputFrames, unsigned long *inputBytes, unsigned long *outputBytes)
 
OSErr SoundConverterBeginConversion (SoundConverter sc)
 
OSErr SoundConverterConvertBuffer (SoundConverter sc, const void *inputPtr, unsigned long inputFrames, void *outputPtr, unsigned long *outputFrames, unsigned long *outputBytes)
 
OSErr SoundConverterEndConversion (SoundConverter sc, void *outputPtr, unsigned long *outputFrames, unsigned long *outputBytes)
 
OSErr SoundConverterGetInfo (SoundConverter sc, OSType selector, void *infoPtr)
 
OSErr SoundConverterSetInfo (SoundConverter sc, OSType selector, void *infoPtr)
 
OSErr SoundConverterFillBuffer (SoundConverter sc, SoundConverterFillBufferDataUPP fillBufferDataUPP, void *fillBufferDataRefCon, void *outputBuffer, unsigned long outputBufferByteSize, unsigned long *bytesWritten, unsigned long *framesWritten, unsigned long *outputFlags)
 
OSErr SoundManagerGetInfo (OSType selector, void *infoPtr)
 
OSErr SoundManagerSetInfo (OSType selector, const void *infoPtr)
 
ComponentResult SoundComponentInitOutputDevice (ComponentInstance ti, long actions)
 
ComponentResult SoundComponentSetSource (ComponentInstance ti, SoundSource sourceID, ComponentInstance source)
 
ComponentResult SoundComponentGetSource (ComponentInstance ti, SoundSource sourceID, ComponentInstance *source)
 
ComponentResult SoundComponentGetSourceData (ComponentInstance ti, SoundComponentDataPtr *sourceData)
 
ComponentResult SoundComponentSetOutput (ComponentInstance ti, SoundComponentDataPtr requested, SoundComponentDataPtr *actual)
 
ComponentResult SoundComponentAddSource (ComponentInstance ti, SoundSource *sourceID)
 
ComponentResult SoundComponentRemoveSource (ComponentInstance ti, SoundSource sourceID)
 
ComponentResult SoundComponentGetInfo (ComponentInstance ti, SoundSource sourceID, OSType selector, void *infoPtr)
 
ComponentResult SoundComponentSetInfo (ComponentInstance ti, SoundSource sourceID, OSType selector, void *infoPtr)
 
ComponentResult SoundComponentStartSource (ComponentInstance ti, short count, SoundSource *sources)
 
ComponentResult SoundComponentStopSource (ComponentInstance ti, short count, SoundSource *sources)
 
ComponentResult SoundComponentPauseSource (ComponentInstance ti, short count, SoundSource *sources)
 
ComponentResult SoundComponentPlaySourceBuffer (ComponentInstance ti, SoundSource sourceID, SoundParamBlockPtr pb, long actions)
 
ComponentResult AudioGetVolume (ComponentInstance ac, short whichChannel, ShortFixed *volume)
 
ComponentResult AudioSetVolume (ComponentInstance ac, short whichChannel, ShortFixed volume)
 
ComponentResult AudioGetMute (ComponentInstance ac, short whichChannel, short *mute)
 
ComponentResult AudioSetMute (ComponentInstance ac, short whichChannel, short mute)
 
ComponentResult AudioSetToDefaults (ComponentInstance ac)
 
ComponentResult AudioGetInfo (ComponentInstance ac, AudioInfoPtr info)
 
ComponentResult AudioGetBass (ComponentInstance ac, short whichChannel, short *bass)
 
ComponentResult AudioSetBass (ComponentInstance ac, short whichChannel, short bass)
 
ComponentResult AudioGetTreble (ComponentInstance ac, short whichChannel, short *Treble)
 
ComponentResult AudioSetTreble (ComponentInstance ac, short whichChannel, short Treble)
 
ComponentResult AudioGetOutputDevice (ComponentInstance ac, Component *outputDevice)
 
ComponentResult AudioMuteOnEvent (ComponentInstance ac, short muteOnEvent)
 
NumVersion SPBVersion (void)
 Determine the version of the sound input routines. More...
 
OSErr SndRecord (ModalFilterUPP filterProc, Point corner, OSType quality, SndListHandle *sndHandle)
 
OSErr SndRecordToFile (ModalFilterUPP filterProc, Point corner, OSType quality, short fRefNum)
 
OSErr SPBSignInDevice (short deviceRefNum, ConstStr255Param deviceName)
 
OSErr SPBSignOutDevice (short deviceRefNum)
 
OSErr SPBGetIndexedDevice (short count, Str255 deviceName, Handle *deviceIconHandle)
 
OSErr SPBOpenDevice (ConstStr255Param deviceName, short permission, long *inRefNum)
 
OSErr SPBCloseDevice (long inRefNum)
 
OSErr SPBRecord (SPBPtr inParamPtr, Boolean asynchFlag)
 
OSErr SPBRecordToFile (short fRefNum, SPBPtr inParamPtr, Boolean asynchFlag)
 
OSErr SPBPauseRecording (long inRefNum)
 SPBPauseRecording Pause recording from the specified device. More...
 
OSErr SPBResumeRecording (long inRefNum)
 SPBResumeRecording Resume recording from the specified device. More...
 
OSErr SPBStopRecording (long inRefNum)
 SPBStopRecording Resume recording from the specified device. More...
 
OSErr SPBGetRecordingStatus (long inRefNum, short *recordingStatus, short *meterLevel, unsigned long *totalSamplesToRecord, unsigned long *numberOfSamplesRecorded, unsigned long *totalMsecsToRecord, unsigned long *numberOfMsecsRecorded)
 SPBGetRecordingStatus Obtain recording status information. More...
 
OSErr SPBGetDeviceInfo (long inRefNum, OSType infoType, void *infoData)
 
OSErr SPBSetDeviceInfo (long inRefNum, OSType infoType, void *infoData)
 
OSErr SPBMillisecondsToBytes (long inRefNum, long *milliseconds)
 
OSErr SPBBytesToMilliseconds (long inRefNum, long *byteCount)
 
OSErr SetupSndHeader (SndListHandle sndHandle, short numChannels, UnsignedFixed sampleRate, short sampleSize, OSType compressionType, short baseNote, unsigned long numBytes, short *headerLen)
 Set up headers for 'snd ' resources. More...
 
OSErr SetupAIFFHeader (short fRefNum, short numChannels, UnsignedFixed sampleRate, short sampleSize, OSType compressionType, unsigned long numBytes, unsigned long numFrames)
 Set up a file that can be played by SndStartFilePlay. More...
 
OSErr ParseAIFFHeader (short fRefNum, SoundComponentData *sndInfo, unsigned long *numFrames, unsigned long *dataOffset)
 
OSErr ParseSndHeader (SndListHandle sndHandle, SoundComponentData *sndInfo, unsigned long *numFrames, unsigned long *dataOffset)
 
typedef CALLBACK_API (void, SICCompletionProcPtr)(SndInputCmpParamPtr SICParmPtr)
 
ComponentResult SndInputReadAsync (ComponentInstance self, SndInputCmpParamPtr SICParmPtr)
 
ComponentResult SndInputReadSync (ComponentInstance self, SndInputCmpParamPtr SICParmPtr)
 
ComponentResult SndInputPauseRecording (ComponentInstance self)
 
ComponentResult SndInputResumeRecording (ComponentInstance self)
 
ComponentResult SndInputStopRecording (ComponentInstance self)
 
ComponentResult SndInputGetStatus (ComponentInstance self, short *recordingStatus, unsigned long *totalSamplesToRecord, unsigned long *numberOfSamplesRecorded)
 
ComponentResult SndInputGetDeviceInfo (ComponentInstance self, OSType infoType, void *infoData)
 
ComponentResult SndInputSetDeviceInfo (ComponentInstance self, OSType infoType, void *infoData)
 
ComponentResult SndInputInitHardware (ComponentInstance self)
 

Detailed Description

Sound Manager Interfaces.

Introduced In: Sound Manager 3.6
Avaliable From: Universal Interfaces 3.4.1
Copyright: © 1986-2001 by Apple Computer, Inc., all rights reserved

For bug reports, consult the following page on the World Wide Web:

http://developer.apple.com/bugreporter/

Macro Definition Documentation

◆ CallSIInterruptProc

#define CallSIInterruptProc (   userRoutine,
  inParamPtr,
  dataBuffer,
  peakAmplitude,
  sampleSize 
)
Value:
InvokeSIInterruptUPP(inParamPtr, dataBuffer, peakAmplitude, sampleSize, \
userRoutine)
void InvokeSIInterruptUPP(SPBPtr inParamPtr, Ptr dataBuffer, short peakAmplitude, long sampleSize, SIInterruptUPP userUPP)

◆ InvokeSIInterruptUPP

#define InvokeSIInterruptUPP (   inParamPtr,
  dataBuffer,
  peakAmplitude,
  sampleSize,
  userUPP 
)
Value:
CALL_FOUR_PARAMETER_UPP((userUPP), uppSIInterruptProcInfo, (inParamPtr), \
(dataBuffer), (peakAmplitude), (sampleSize))

◆ InvokeSndDoubleBackUPP

#define InvokeSndDoubleBackUPP (   channel,
  doubleBufferPtr,
  userUPP 
)
Value:
CALL_TWO_PARAMETER_UPP((userUPP), uppSndDoubleBackProcInfo, (channel), \
Definition: Sound.h:1048

◆ InvokeSoundConverterFillBufferDataUPP

#define InvokeSoundConverterFillBufferDataUPP (   data,
  refCon,
  userUPP 
)
Value:
(Boolean) CALL_TWO_PARAMETER_UPP( \
(userUPP), uppSoundConverterFillBufferDataProcInfo, (data), (refCon))
unsigned char Boolean
Definition: MacTypes.h:318

◆ NewFilePlayCompletionProc

#define NewFilePlayCompletionProc (   userRoutine)     NewFilePlayCompletionUPP(userRoutine)

CALL_NOT_IN_CARBON support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewFilePlayCompletionUPP

#define NewFilePlayCompletionUPP (   userRoutine)
Value:
(FilePlayCompletionUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), \
uppFilePlayCompletionProcInfo, \
GetCurrentArchitecture())
UniversalProcPtr NewRoutineDescriptor(ProcPtr theProc, ProcInfoType theProcInfo, ISAType theISA)

pascal no_return_value Func(4_bytes)

◆ NewSICompletionUPP

#define NewSICompletionUPP (   userRoutine)
Value:
(SICompletionUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppSICompletionProcInfo, \
GetCurrentArchitecture())

pascal no_return_value Func(4_bytes)

◆ NewSIInterruptUPP

#define NewSIInterruptUPP (   userRoutine)
Value:
(SIInterruptUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppSIInterruptProcInfo, \
GetCurrentArchitecture())

register no_return_value Func(4_bytes:A0, 4_bytes:A1, 2_bytes:D0, 4_bytes:D1)

◆ NewSndCallBackProc

#define NewSndCallBackProc (   userRoutine)    NewSndCallBackUPP(userRoutine)

support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewSndCallBackUPP

#define NewSndCallBackUPP (   userRoutine)
Value:
(SndCallBackUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppSndCallBackProcInfo, \
GetCurrentArchitecture())

pascal no_return_value Func(4_bytes, 4_bytes)

◆ NewSndDoubleBackProc

#define NewSndDoubleBackProc (   userRoutine)    NewSndDoubleBackUPP(userRoutine)

CALL_NOT_IN_CARBON support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewSndDoubleBackUPP

#define NewSndDoubleBackUPP (   userRoutine)
Value:
(SndDoubleBackUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppSndDoubleBackProcInfo, \
GetCurrentArchitecture())

pascal no_return_value Func(4_bytes, 4_bytes)

◆ NewSoundConverterFillBufferDataUPP

#define NewSoundConverterFillBufferDataUPP (   userRoutine)
Value:
(SoundConverterFillBufferDataUPP) NewRoutineDescriptor( \
(ProcPtr)(userRoutine), uppSoundConverterFillBufferDataProcInfo, \
GetCurrentArchitecture())

pascal 1_byte Func(4_bytes, 4_bytes)

◆ NewSoundParamProc

#define NewSoundParamProc (   userRoutine)    NewSoundParamUPP(userRoutine)

support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewSoundParamUPP

#define NewSoundParamUPP (   userRoutine)
Value:
(SoundParamUPP) NewRoutineDescriptor( \
(ProcPtr)(userRoutine), uppSoundParamProcInfo, GetCurrentArchitecture())

pascal 1_byte Func(4_bytes)

◆ twelfthRootTwo

#define twelfthRootTwo   1.05946309435
                   * *  N O T E  * * *

This file has been updated to include Sound Manager 3.3 interfaces.

Some of the Sound Manager 3.0 interfaces were not put into the InterfaceLib that originally shipped with the PowerMacs. These missing functions and the new 3.3 interfaces have been released in the SoundLib library for PowerPC developers to link with. The runtime library for these functions are installed by the Sound Manager. The following functions are found in SoundLib.

 GetCompressionInfo(), GetSoundPreference(), SetSoundPreference(),
 UnsignedFixedMulDiv(), SndGetInfo(), SndSetInfo(), GetSoundOutputInfo(),
 SetSoundOutputInfo(), GetCompressionName(), SoundConverterOpen(),
 SoundConverterClose(), SoundConverterGetBufferSizes(),

SoundConverterBeginConversion(), SoundConverterConvertBuffer(), SoundConverterEndConversion(), AudioGetBass(), AudioGetInfo(), AudioGetMute(), AudioGetOutputDevice(), AudioGetTreble(), AudioGetVolume(), AudioMuteOnEvent(), AudioSetBass(), AudioSetMute(), AudioSetToDefaults(), AudioSetTreble(), AudioSetVolume(), OpenMixerSoundComponent(), CloseMixerSoundComponent(), SoundComponentAddSource(), SoundComponentGetInfo(), SoundComponentGetSource(), SoundComponentGetSourceData(), SoundComponentInitOutputDevice(), SoundComponentPauseSource(), SoundComponentPlaySourceBuffer(), SoundComponentRemoveSource(), SoundComponentSetInfo(), SoundComponentSetOutput(), SoundComponentSetSource(), SoundComponentStartSource(), SoundComponentStopSource(), ParseAIFFHeader(), ParseSndHeader(), SoundConverterGetInfo(), SoundConverterSetInfo() Interfaces for Sound Driver, !!! OBSOLETE and NOT SUPPORTED !!!

These items are no longer defined, but appear here so that someone searching the interfaces might find them. If you are using one of these items, you must change your code to support the Sound Manager.

swMode, ftMode, ffMode
FreeWave, FFSynthRec, Tone, SWSynthRec, Wave, FTSoundRec
SndCompletionProcPtr
StartSound, StopSound, SoundDone
SetSoundVol, GetSoundVol
constants

Typedef Documentation

◆ SndInputCmpParam

Only to be used if you are writing a sound input component; this is the param block for a read request from the SoundMgr to the
sound input component. Not to be confused with the SPB struct
above, which is the param block for a read request from an app
to the SoundMgr.

◆ SoundConverter

typedef struct OpaqueSoundConverter* SoundConverter

private thing to use as a reference to a Sound Converter

◆ SoundSource

typedef struct OpaqueSoundSource* SoundSource

private thing to use as a reference to a Sound Source

◆ SPB

typedef struct SPB SPB

Sound Input Structures

Enumeration Type Documentation

◆ anonymous enum

anonymous enum
Enumerator
rate44khz 

48000.00000 in fixed-point

rate32khz 

44100.00000 in fixed-point

rate22050hz 

32000.00000 in fixed-point

rate22khz 

22050.00000 in fixed-point

rate16khz 

22254.54545 in fixed-point

rate11khz 

16000.00000 in fixed-point

rate11025hz 

11127.27273 in fixed-point

rate8khz 

11025.00000 in fixed-point

◆ anonymous enum

anonymous enum

synthesizer numbers for SndNewChannel

◆ anonymous enum

anonymous enum
Enumerator
waveTableSynth 

square wave synthesizer

MACE3snthID 

wave table synthesizer old Sound Manager MACE synthesizer numbers

◆ anonymous enum

anonymous enum

CALL_NOT_IN_CARBON

◆ anonymous enum

anonymous enum
Enumerator
kFullVolume 

setting for no sound volume

◆ anonymous enum

anonymous enum
Enumerator
fixedCompression 

compression ID's

variableCompression 

compression ID for fixed-sized compression

◆ anonymous enum

anonymous enum
Enumerator
secondSoundFormat 

general sound format

◆ anonymous enum

anonymous enum
Enumerator
dbLastBuffer 

double buffer is filled

◆ anonymous enum

anonymous enum

CALL_NOT_IN_CARBON

Enumerator
sysBeepEnable 

SysBeep() enable flags

◆ anonymous enum

anonymous enum
Enumerator
unitTypeSeconds 

unitTypes for AudioSelection.unitType

◆ anonymous enum

anonymous enum
Enumerator
extSH 

Standard sound header encode value

cmpSH 

Extended sound header encode value

◆ anonymous enum

anonymous enum

command numbers for SndDoCommand and SndDoImmediate

Enumerator
getVolumeCmd 

sound manager 3.0 or later only

clockComponentCmd 

sound manager 3.0 or later only

getClockComponentCmd 

sound manager 3.2.1 or later only

scheduledSoundCmd 

sound manager 3.2.1 or later only

linkSoundComponentsCmd 

sound manager 3.3 or later only

soundCmd 

sound manager 3.3 or later only

◆ anonymous enum

anonymous enum

command numbers for SndDoCommand and SndDoImmediate that are not available for use in Carbon

Enumerator
convertCmd 

obsolete command

◆ anonymous enum

anonymous enum

CALL_NOT_IN_CARBON OLDROUTINENAMES

Enumerator
initChanRight 

left stereo channel

initNoInterp 

right stereo channel

initNoDrop 

no linear interpolation

initMono 

no drop-sample conversion

initStereo 

monophonic channel

initMACE3 

stereo channel

initMACE6 

MACE 3:1

initPanMask 

MACE 6:1

initSRateMask 

mask for right/left pan values

initStereoMask 

mask for sample rate values

initCompMask 

mask for mono/stereo values

◆ anonymous enum

anonymous enum

Get&Set Sound Information Selectors

Enumerator
siActiveLevels 

active channels

siAGCOnOff 

active meter levels

siAsync 

automatic gain control state

siAVDisplayBehavior 

asynchronous capability

siCompressionAvailable 

number of channels available

siCompressionChannels 

compression types available

siCompressionFactor 

compressor's number of channels

siCompressionHeader 

current compression factor

siCompressionNames 

return compression header

siCompressionParams 

compression type names available

siCompressionSampleRate 

compression parameters

siCompressionType 

compressor's sample rate

siContinuous 

current compression type

siDecompressionParams 

continous recording

siDeviceBufferInfo 

decompression parameters

siDeviceConnected 

size of interrupt buffer

siDeviceIcon 

input device connection status

siDeviceName 

input device icon

siEQSpectrumBands 

input device name

siEQSpectrumLevels 

number of spectrum bands

siEQSpectrumOnOff 

gets spectum meter levels

siEQSpectrumResolution 

turn on/off spectum meter levels

siEQToneControlGain 

set the resolution of the FFT, 0 = low res (<=16 bands), 1 = high res (16-64 bands)

siEQToneControlOnOff 

set the bass and treble gain

siHardwareBalance 

turn on equalizer attenuation

siHardwareFormat 

sound hardware is in use

siHardwareMute 

get hardware format

siHardwareMuteNoPrefs 

mute state of all hardware

siHardwareTreble 

mute state of all hardware, but don't store in prefs

siHardwareVolumeSteps 

volume level of all hardware

siHeadphoneMute 

number of volume steps for hardware

siHeadphoneVolume 

mute state of headphones

siHeadphoneVolumeSteps 

volume level of headphones

siInputAvailable 

number of volume steps for headphones

siInputGain 

input sources available

siInputSource 

input gain

siInputSourceNames 

input source selector

siLevelMeterOnOff 

input source names

siModemGain 

level meter state

siMonitorAvailable 

modem input gain

siOptionsDialog 

current number of channels

siOSTypeInputSource 

display options dialog

siOSTypeInputAvailable 

input source by OSType

siOutputDeviceName 

list of available input source OSTypes

siPlayThruOnOff 

output device name

siPostMixerSoundComponent 

playthrough state

siPreMixerSoundComponent 

install post-mixer effect

siQuality 

install pre-mixer effect

siRateMultiplier 

quality setting

siRecordingQuality 

throttle rate setting

siSampleRate 

recording quality

siSampleRateAvailable 

current sample rate

siSampleSize 

sample rates available

siSampleSizeAvailable 

current sample size

siSetupCDAudio 

sample sizes available

siSetupModemAudio 

setup sound hardware for CD audio

siSlopeAndIntercept 

setup sound hardware for modem audio

siSoundClock 

floating point variables for conversion

siSpeakerMute 

sdev uses this to tell the mixer to use his sound clock

siSpeakerVolume 

mute state of all built-in speaker

siSSpCPULoadLimit 

volume level of built-in speaker

siSubwooferMute 

stereo input gain

siTerminalType 

mute state of sub-woofer

siTwosComplementOnOff 

usb terminal type

siVendorProduct 

two's complement state

siVolume 

vendor and product ID

siVoxRecordInfo 

volume level of source

siVoxStopInfo 

VOX record parameters

siWideStereo 

VOX stop parameters

siSupportedExtendedFlags 

wide stereo setting

siRateConverterRollOffSlope 

which flags are supported in Extended sound data structures

siOutputLatency 

the roll-off slope for the rate converter's filter, in whole dB as a long this value is a long whose range is from 20 (worst quality/fastest performance) to 90 (best quality/slowest performance)

◆ anonymous enum

anonymous enum
Enumerator
siInitializeDriver 

reserved for internal use only

siPauseRecording 

reserved for internal use only

siUserInterruptProc 

reserved for internal use only

◆ anonymous enum

anonymous enum

input source Types

Enumerator
kNoSource 

this source may be returned from GetInfo if no other source is the monitored source

kCDSource 

no source selection

kExtMicSource 

internal CD player input

kSoundInSource 

external mic input

kRCAInSource 

sound input jack

kTVFMTunerSource 

RCA jack input

kIntMicSource 

DAV analog input

kMediaBaySource 

internal mic input

kModemSource 

media bay input

kPCCardSource 

modem input (internal modem on desktops, PCI input on PowerBooks)

kZoomVideoSource 

PC Card pwm input

kDVDSource 

zoom video input

kMicrophoneArray 

DVD audio input

◆ anonymous enum

anonymous enum

Sound Component Types and Subtypes

Enumerator
kSoundComponentPPCType 

component type

kRate8SubType 

component type for PowerPC code

kRate16SubType 

8-bit rate converter

kConverterSubType 

16-bit rate converter

kSndSourceSubType 

sample format converter

kMixerType 

generic source component

kMixer16SubType 

8-bit mixer

kSoundInputDeviceType 

16-bit mixer

kWaveInSubType 

sound input component

kWaveInSnifferSubType 

Windows waveIn

kSoundOutputDeviceType 

Windows waveIn sniffer

kClassicSubType 

sound output component

kASCSubType 

classic hardware, i.e. Mac Plus

kDSPSubType 

Apple Sound Chip device

kAwacsSubType 

DSP device

kGCAwacsSubType 

Another of Will's Audio Chips device

kSingerSubType 

Awacs audio with Grand Central DMA

kSinger2SubType 

Singer (via Whitney) based sound

kWhitSubType 

Singer 2 (via Whitney) for Acme

kSoundBlasterSubType 

Whit sound component for PrimeTime 3

kWaveOutSubType 

Sound Blaster for CHRP

kWaveOutSnifferSubType 

Windows waveOut

kDirectSoundSubType 

Windows waveOut sniffer

kDirectSoundSnifferSubType 

Windows DirectSound

kUNIXsdevSubType 

Windows DirectSound sniffer

kUSBSubType 

UNIX base sdev

kBlueBoxSubType 

USB device

kSoundCompressor 

Blue Box sound component

kAwacsPhoneSubType 

Audio components and sub-types

kEqualizerSubType 

sound effects type

kSSpLocalizationSubType 

frequency equalizer

◆ anonymous enum

anonymous enum

Format Types

Enumerator
k8BitOffsetBinaryFormat 

sound is not compressed

k16BitBigEndianFormat 

8-bit offset binary

k16BitLittleEndianFormat 

16-bit big endian

kFloat32Format 

16-bit little endian

kFloat64Format 

32-bit floating point

k24BitFormat 

64-bit floating point

k32BitFormat 

24-bit integer

k32BitLittleEndianFormat 

32-bit integer

kMACE3Compression 

32-bit little endian integer

kMACE6Compression 

MACE 3:1

kCDXA4Compression 

MACE 6:1

kCDXA2Compression 

CD/XA 4:1

kIMACompression 

CD/XA 2:1

kULawCompression 

IMA 4:1

kALawCompression 

©Law 2:1

kMicrosoftADPCMFormat 

aLaw 2:1

kDVIIntelIMAFormat 

Microsoft ADPCM - ACM code 2

kDVAudioFormat 

DVI/Intel IMA ADPCM - ACM code 17

kQDesignCompression 

DV Audio

kQDesign2Compression 

QDesign music

kQUALCOMMCompression 

QDesign2 music

kOffsetBinary 

QUALCOMM PureVoice

kTwosComplement 

for compatibility

kLittleEndianFormat 

for compatibility

kMPEGLayer3Format 

for compatibility

kFullMPEGLay3Format 

MPEG Layer 3, CBR only (pre QT4.1)

◆ anonymous enum

anonymous enum

TARGET_RT_LITTLE_ENDIAN Features Flags

Enumerator
k8BitTwosIn 

data description

kRateConvert 

function description

kHighQuality 

component will hold its memory

kNonRealTime 

performance description

◆ anonymous enum

anonymous enum

SoundComponentPlaySourceBuffer action flags

◆ anonymous enum

anonymous enum

SoundParamBlock flags, usefull for OpenMixerSoundComponent

Enumerator
kNoSampleRateConversion 

don't mix source

kNoSampleSizeConversion 

don't convert sample rate (i.e. 11 kHz -> 22 kHz)

kNoSampleFormatConversion 

don't convert sample size (i.e. 16 -> 8)

kNoChannelConversion 

don't convert sample format (i.e. 'twos' -> 'raw ')

kNoDecompression 

don't convert stereo/mono

kNoVolumeConversion 

don't decompress (i.e. 'MAC3' -> 'raw ')

kNoRealtimeProcessing 

don't apply volume

kScheduledSource 

won't run at interrupt time

kNonInterleavedBuffer 

source is scheduled

kNonPagingMixer 

buffer is not interleaved samples

kSoundConverterMixer 

if VM is on, use the non-paging mixer

kPagingMixer 

the mixer is to be used by the SoundConverter

kVMAwareMixer 

the mixer is to be used as a paging mixer when VM is on

kExtendedSoundData 

passed to the output device when the SM is going to deal with VM safety

◆ anonymous enum

anonymous enum

SoundParamBlock quality settings

◆ anonymous enum

anonymous enum

useful bit masks

Enumerator
kOutputMask 

masks off input bits

kOutputShift 

masks off output bits

kActionMask 

amount output bits are shifted

kSoundComponentBits 

masks off action bits

◆ anonymous enum

anonymous enum

audio atom types

◆ anonymous enum

anonymous enum

siAVDisplayBehavior types

Enumerator
kAVDisplayHeadphoneInsert 

monitor does not have a headphone attached

kAVDisplayPlainTalkRemove 

monitor has a headphone attached

kAVDisplayPlainTalkInsert 

monitor either sending no input through CPU input port or unable to tell if input is coming in

◆ anonymous enum

anonymous enum

Audio Component constants

Enumerator
audioAllChannels 

Values for whichChannel parameter

audioLeftChannel 

All channels (usually interpreted as both left and right)

audioRightChannel 

Left channel

audioUnmuted 

Right channel Values for mute parameter

audioMuted 

Device is unmuted

audioDoesMono 

Device is muted Capabilities flags definitions

audioDoesStereo 

Device supports mono output

audioDoesIndependentChannels 

Device supports stereo output

◆ anonymous enum

anonymous enum

Sound Input Qualities

Enumerator
siBestQuality 

44.1kHz, stereo, 16 bit

siBetterQuality 

22kHz, mono, 8 bit

siGoodQuality 

22kHz, mono, MACE 3:1

siNoneQuality 

22kHz, mono, MACE 6:1

◆ anonymous enum

anonymous enum
Enumerator
siDeviceNotConnected 

input device is connected and ready for input

siDontKnowIfConnected 

input device is not connected

siReadPermission 

can't tell if input device is connected

siWritePermission 

permission passed to SPBOpenDevice

◆ anonymous enum

anonymous enum

flags that SoundConverterFillBuffer will return

Enumerator
kSoundConverterHasLeftOverData 

set if the converter couldn't completely satisfy a SoundConverterFillBuffer request

◆ anonymous enum

anonymous enum

flags for extendedFlags fields of ExtendedSoundComponentData, ExtendedSoundParamBlock, and ExtendedScheduledSoundHeader

Enumerator
kExtendedSoundBufferSizeValid 

set if sampleCount of SoundComponentData isn't meaningful; use buffer size instead

◆ anonymous enum

anonymous enum

◆ anonymous enum

anonymous enum

selectors for component calls

◆ anonymous enum

anonymous enum

selectors for component calls

◆ anonymous enum

anonymous enum

CALL_NOT_IN_CARBON

◆ anonymous enum

anonymous enum

selectors for component calls

◆ anonymous enum

anonymous enum

selectors for component calls

Function Documentation

◆ AudioGetBass()

ComponentResult AudioGetBass ( ComponentInstance  ac,
short  whichChannel,
short *  bass 
)

AudioGetBass()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioGetInfo()

ComponentResult AudioGetInfo ( ComponentInstance  ac,
AudioInfoPtr  info 
)

This routine is required; it must be implemented by all audio components AudioGetInfo()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioGetMute()

ComponentResult AudioGetMute ( ComponentInstance  ac,
short  whichChannel,
short *  mute 
)

If the device doesn't support software control of mute, then a value of unimpErr is returned, indicating that these functions are not supported by the device. AudioGetMute()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioGetOutputDevice()

ComponentResult AudioGetOutputDevice ( ComponentInstance  ac,
Component outputDevice 
)

AudioGetOutputDevice()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioGetTreble()

ComponentResult AudioGetTreble ( ComponentInstance  ac,
short  whichChannel,
short *  Treble 
)

AudioGetTreble()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioGetVolume()

ComponentResult AudioGetVolume ( ComponentInstance  ac,
short  whichChannel,
ShortFixed *  volume 
)

Audio Components Volume is described as a value between 0 and 1, with 0 indicating minimum volume and 1 indicating maximum volume; if the device doesn't support software control of volume, then a value of unimpErr is returned, indicating that these functions are not supported by the device AudioGetVolume()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioMuteOnEvent()

ComponentResult AudioMuteOnEvent ( ComponentInstance  ac,
short  muteOnEvent 
)

This is routine is private to the AudioVision component. It enables the watching of the mute key. AudioMuteOnEvent()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioSetBass()

ComponentResult AudioSetBass ( ComponentInstance  ac,
short  whichChannel,
short  bass 
)

AudioSetBass()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioSetMute()

ComponentResult AudioSetMute ( ComponentInstance  ac,
short  whichChannel,
short  mute 
)

AudioSetMute()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioSetToDefaults()

ComponentResult AudioSetToDefaults ( ComponentInstance  ac)

AudioSetToDefaults causes the associated device to reset its volume and mute values (and perhaps other characteristics, e.g. attenuation) to "factory default" settings AudioSetToDefaults()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioSetTreble()

ComponentResult AudioSetTreble ( ComponentInstance  ac,
short  whichChannel,
short  Treble 
)

AudioSetTreble()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ AudioSetVolume()

ComponentResult AudioSetVolume ( ComponentInstance  ac,
short  whichChannel,
ShortFixed  volume 
)

AudioSetVolume()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: not available
Mac OS X: not available

◆ CALLBACK_API() [1/2]

typedef CALLBACK_API ( Boolean  ,
SoundConverterFillBufferDataProcPtr   
)

callback routine to provide data to the Sound Converter

◆ CALLBACK_API() [2/2]

typedef CALLBACK_API ( void  ,
FilePlayCompletionProcPtr   
)

CALL_NOT_IN_CARBON

◆ CALLBACK_API_REGISTER68K()

typedef CALLBACK_API_REGISTER68K ( void  ,
SIInterruptProcPtr  ,
(SPBPtr inParamPtr, Ptr dataBuffer, short peakAmplitude, long sampleSize)   
)

user procedures called by sound input routines

◆ CloseMixerSoundComponent()

OSErr CloseMixerSoundComponent ( ComponentInstance  ci)

CloseMixerSoundComponent()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ Comp3to1()

void Comp3to1 ( const void *  inBuffer,
void *  outBuffer,
unsigned long  cnt,
StateBlockPtr  inState,
StateBlockPtr  outState,
unsigned long  numChannels,
unsigned long  whichChannel 
)

Comp3to1()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ Comp6to1()

void Comp6to1 ( const void *  inBuffer,
void *  outBuffer,
unsigned long  cnt,
StateBlockPtr  inState,
StateBlockPtr  outState,
unsigned long  numChannels,
unsigned long  whichChannel 
)

Comp6to1()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ DisposeFilePlayCompletionUPP()

void DisposeFilePlayCompletionUPP ( FilePlayCompletionUPP  userUPP)

DisposeFilePlayCompletionUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: not available
Mac OS X: not available

◆ DisposeSICompletionUPP()

void DisposeSICompletionUPP ( SICompletionUPP  userUPP)

DisposeSICompletionUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeSIInterruptUPP()

void DisposeSIInterruptUPP ( SIInterruptUPP  userUPP)

DisposeSIInterruptUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeSndCallBackUPP()

void DisposeSndCallBackUPP ( SndCallBackUPP  userUPP)

DisposeSndCallBackUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeSndDoubleBackUPP()

void DisposeSndDoubleBackUPP ( SndDoubleBackUPP  userUPP)

DisposeSndDoubleBackUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: not available
Mac OS X: not available

◆ DisposeSoundConverterFillBufferDataUPP()

void DisposeSoundConverterFillBufferDataUPP ( SoundConverterFillBufferDataUPP  userUPP)

DisposeSoundConverterFillBufferDataUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.1 and later
Mac OS X: in version 10.0 and later

◆ DisposeSoundParamUPP()

void DisposeSoundParamUPP ( SoundParamUPP  userUPP)

DisposeSoundParamUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ Exp1to3()

void Exp1to3 ( const void *  inBuffer,
void *  outBuffer,
unsigned long  cnt,
StateBlockPtr  inState,
StateBlockPtr  outState,
unsigned long  numChannels,
unsigned long  whichChannel 
)

Exp1to3()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ Exp1to6()

void Exp1to6 ( const void *  inBuffer,
void *  outBuffer,
unsigned long  cnt,
StateBlockPtr  inState,
StateBlockPtr  outState,
unsigned long  numChannels,
unsigned long  whichChannel 
)

Exp1to6()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ GetCompressionInfo()

OSErr GetCompressionInfo ( short  compressionID,
OSType  format,
short  numChannels,
short  sampleSize,
CompressionInfoPtr  cp 
)

GetCompressionInfo()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetCompressionName()

OSErr GetCompressionName ( OSType  compressionType,
Str255  compressionName 
)

Sound Manager 3.2 and later calls, uses _SoundDispatch GetCompressionName()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetDefaultOutputVolume()

OSErr GetDefaultOutputVolume ( long *  level)

GetDefaultOutputVolume()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetSoundHeaderOffset()

OSErr GetSoundHeaderOffset ( SndListHandle  sndHandle,
long *  offset 
)

GetSoundHeaderOffset()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetSoundOutputInfo()

OSErr GetSoundOutputInfo ( Component  outputDevice,
OSType  selector,
void *  infoPtr 
)

GetSoundOutputInfo()

Non-Carbon CFM: in SoundLib 3.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetSoundPreference()

OSErr GetSoundPreference ( OSType  theType,
Str255  name,
Handle  settings 
)

GetSoundPreference()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetSysBeepVolume()

OSErr GetSysBeepVolume ( long *  level)

Sound Manager 3.0 and later calls, uses _SoundDispatch CALL_NOT_IN_CARBON GetSysBeepVolume()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeFilePlayCompletionUPP()

void InvokeFilePlayCompletionUPP ( SndChannelPtr  chan,
FilePlayCompletionUPP  userUPP 
)

InvokeFilePlayCompletionUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: not available
Mac OS X: not available

◆ InvokeSICompletionUPP()

void InvokeSICompletionUPP ( SPBPtr  inParamPtr,
SICompletionUPP  userUPP 
)

InvokeSICompletionUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeSIInterruptUPP()

void InvokeSIInterruptUPP ( SPBPtr  inParamPtr,
Ptr  dataBuffer,
short  peakAmplitude,
long  sampleSize,
SIInterruptUPP  userUPP 
)

InvokeSIInterruptUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeSndCallBackUPP()

void InvokeSndCallBackUPP ( SndChannelPtr  chan,
SndCommand cmd,
SndCallBackUPP  userUPP 
)

InvokeSndCallBackUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeSndDoubleBackUPP()

void InvokeSndDoubleBackUPP ( SndChannelPtr  channel,
SndDoubleBufferPtr  doubleBufferPtr,
SndDoubleBackUPP  userUPP 
)

InvokeSndDoubleBackUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: not available
Mac OS X: not available

◆ InvokeSoundConverterFillBufferDataUPP()

Boolean InvokeSoundConverterFillBufferDataUPP ( SoundComponentDataPtr data,
void *  refCon,
SoundConverterFillBufferDataUPP  userUPP 
)

InvokeSoundConverterFillBufferDataUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.1 and later
Mac OS X: in version 10.0 and later

◆ InvokeSoundParamUPP()

Boolean InvokeSoundParamUPP ( SoundParamBlockPtr pb,
SoundParamUPP  userUPP 
)

InvokeSoundParamUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ MACEVersion()

NumVersion MACEVersion ( void  )

Determine the version of the MACE tools.

MACE compression routines, uses _SoundDispatch

You can use MACEVersion to determine the version of the MACE tools
available on a machine.
Returns: a version number that contains the same information as in the
first 4 bytes of a 'vers' resource.
Note
 You can call MACEVersion at interrupt time.
You can obtain information about a sound channel and about the
Sound Manager itself by calling the SndControl , SndChannelStatus ,
and SndManagerStatus functions. You can obtain the version numbers of
the Sound Manager , the MACE tools, and the sound input routines by
calling the SndSoundManagerVersion , MACEVersion , and
SPBVersion functions, respectively.
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ NewFilePlayCompletionUPP()

FilePlayCompletionUPP NewFilePlayCompletionUPP ( FilePlayCompletionProcPtr  userRoutine)

NewFilePlayCompletionUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: not available
Mac OS X: not available

◆ NewSICompletionUPP()

SICompletionUPP NewSICompletionUPP ( SICompletionProcPtr  userRoutine)

NewSICompletionUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewSIInterruptUPP()

SIInterruptUPP NewSIInterruptUPP ( SIInterruptProcPtr  userRoutine)

NewSIInterruptUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewSndCallBackUPP()

SndCallBackUPP NewSndCallBackUPP ( SndCallBackProcPtr  userRoutine)

NewSndCallBackUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewSndDoubleBackUPP()

SndDoubleBackUPP NewSndDoubleBackUPP ( SndDoubleBackProcPtr  userRoutine)

NewSndDoubleBackUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: not available
Mac OS X: not available

◆ NewSoundConverterFillBufferDataUPP()

SoundConverterFillBufferDataUPP NewSoundConverterFillBufferDataUPP ( SoundConverterFillBufferDataProcPtr  userRoutine)

NewSoundConverterFillBufferDataUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.1 and later
Mac OS X: in version 10.0 and later

◆ NewSoundParamUPP()

SoundParamUPP NewSoundParamUPP ( SoundParamProcPtr  userRoutine)

NewSoundParamUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ OpenMixerSoundComponent()

OSErr OpenMixerSoundComponent ( SoundComponentDataPtr  outputDescription,
long  outputFlags,
ComponentInstance mixerComponent 
)

OpenMixerSoundComponent()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ ParseAIFFHeader()

OSErr ParseAIFFHeader ( short  fRefNum,
SoundComponentData sndInfo,
unsigned long *  numFrames,
unsigned long *  dataOffset 
)

Sound Input Manager 1.1 and later calls, uses _SoundDispatch ParseAIFFHeader()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ ParseSndHeader()

OSErr ParseSndHeader ( SndListHandle  sndHandle,
SoundComponentData sndInfo,
unsigned long *  numFrames,
unsigned long *  dataOffset 
)

ParseSndHeader()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetDefaultOutputVolume()

OSErr SetDefaultOutputVolume ( long  level)

SetDefaultOutputVolume()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetSoundOutputInfo()

OSErr SetSoundOutputInfo ( Component  outputDevice,
OSType  selector,
const void *  infoPtr 
)

SetSoundOutputInfo()

Non-Carbon CFM: in SoundLib 3.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetSoundPreference()

OSErr SetSoundPreference ( OSType  theType,
Str255  name,
Handle  settings 
)

SetSoundPreference()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetSysBeepVolume()

OSErr SetSysBeepVolume ( long  level)

SetSysBeepVolume()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetupAIFFHeader()

OSErr SetupAIFFHeader ( short  fRefNum,
short  numChannels,
UnsignedFixed  sampleRate,
short  sampleSize,
OSType  compressionType,
unsigned long  numBytes,
unsigned long  numFrames 
)

Set up a file that can be played by SndStartFilePlay.

Depending on the parameters passed, SetupAIFFHeader creates an AIFF or
AIFF-C file header:
•Uncompressed sounds of any type are stored in AIFF format (that is,
compressionType is 'NONE').
•Compressed sounds of any type are stored in AIFF-C format (that is,
compressionType is different from 'NONE').
fRefNum contains a file reference number for a file that is open for
writing.The AIFF header information is written starting at the
current file position, and the file position is left at the end of the
header upon completion.
numChannels specifies the number of channels for the sound .
sampleRate specifies the sampling rate for the sound (that is, samples per
second). Note that the most significant bit of this value is interpreted
as having the value 32,768 (not as a sign bit)
sampleSize specifies the sample size for the sound (that is, bits per sample)
compressionType specifies the compression type for the sound ('NONE', 'MAC3',
'MAC6', or other third-party types)
baseFrequency specifies the base frequency for the sound
numBytes specifies the number of bytes of audio data that are to be stored in
the Common Chunk of the AIFF or AIFF-C file. This data should be
stored right after the sound header in the file. (This value is not
necessarily the same as the number of samples in the sound.)
numFrames specifies the number of sample frames for the sound. A value needs
to be passed here only for third-party compression types. If you are
using 'NONE', 'MAC3', or 'MAC6' compression types, you can pass a 0
in this field, and SetupAIFFHeader will calculate the number of
sample frames and store it in the header..
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetupSndHeader()

OSErr SetupSndHeader ( SndListHandle  sndHandle,
short  numChannels,
UnsignedFixed  sampleRate,
short  sampleSize,
OSType  compressionType,
short  baseNote,
unsigned long  numBytes,
short *  headerLen 
)

Set up headers for 'snd ' resources.

You can use SetupSndHeader to construct a sampled sound header that can
be passed to SndPlay or stored as an 'snd ' resource. SetupSndHeader
creates a format 1 'snd ' resource header for a sampled sound only, containing
one synthesizer field (the sampled synthesizer) and one sound command (a
bufferCmd command to play the accompanying data). A sampled sound header
is stored immediately following the sound command and is in one of three
formats depending on several of the parameters passed. The Table below shows
how SetupSndHeader determines what kind of sound header to create
sndHandle is a handle that is at least large enough to store the 'snd ' header
information. The handle is not resized in any way upon successful
completion of SetupSndHeader . SetupSndHeader simply fills the
beginning of the handle with the header information needed for a
format 1 'snd ' resource. It is your application's responsibility to
append the desired sampled sound data.
numChannels specifies the number of channels for the sound .
sampleRate specifies the sampling rate for the sound (that is, samples per
second). Note that the most significant bit of this value is interpreted
as having the value 32,768 (not as a sign bit)
sampleSize specifies the sample size for the sound (that is, bits per sample)
compressionType specifies the compression type for the sound ('NONE', 'MAC3',
'MAC6', or other third-party types)
baseFrequency specifies the base frequency for the sound
numBytes specifies the number of bytes of audio data that are to be stored in
the handle. (This value is not necessarily the same as the number of
samples in the sound.)
headerLen returns the size of the 'snd ' resource header that is created, in
bytes. This allows you to put the audio data right after the header in
the handle. The value returned depends on the type of sound header
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndChannelStatus()

OSErr SndChannelStatus ( SndChannelPtr  chan,
short  theLength,
SCStatusPtr  theStatus 
)

CALL_NOT_IN_CARBON SndChannelStatus()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndControl()

OSErr SndControl ( short  id,
SndCommand cmd 
)

OLDROUTINENAMES SndControl()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SndDisposeChannel()

OSErr SndDisposeChannel ( SndChannelPtr  chan,
Boolean  quietNow 
)

SndDisposeChannel()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndDoCommand()

OSErr SndDoCommand ( SndChannelPtr  chan,
const SndCommand cmd,
Boolean  noWait 
)

SndDoCommand()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndDoImmediate()

OSErr SndDoImmediate ( SndChannelPtr  chan,
const SndCommand cmd 
)

SndDoImmediate()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndGetInfo()

OSErr SndGetInfo ( SndChannelPtr  chan,
OSType  selector,
void *  infoPtr 
)

Sound Manager 3.1 and later calls, uses _SoundDispatch SndGetInfo()

Non-Carbon CFM: in SoundLib 3.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndGetSysBeepState()

void SndGetSysBeepState ( short *  sysBeepState)

SndGetSysBeepState Determine whether SysBeep is enabled.

The SndGetSysBeepState procedure is used to determine whether SysBeep
is enabled.
sysBeepState is one of two states , either the sysBeepDisable or the
sysBeepEnable constant.
Returns: none
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndInputGetDeviceInfo()

ComponentResult SndInputGetDeviceInfo ( ComponentInstance  self,
OSType  infoType,
void *  infoData 
)

SndInputGetDeviceInfo()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputGetStatus()

ComponentResult SndInputGetStatus ( ComponentInstance  self,
short *  recordingStatus,
unsigned long *  totalSamplesToRecord,
unsigned long *  numberOfSamplesRecorded 
)

SndInputGetStatus()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputInitHardware()

ComponentResult SndInputInitHardware ( ComponentInstance  self)

SndInputInitHardware()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputPauseRecording()

ComponentResult SndInputPauseRecording ( ComponentInstance  self)

SndInputPauseRecording()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputReadAsync()

ComponentResult SndInputReadAsync ( ComponentInstance  self,
SndInputCmpParamPtr  SICParmPtr 
)

SndInputReadAsync()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputReadSync()

ComponentResult SndInputReadSync ( ComponentInstance  self,
SndInputCmpParamPtr  SICParmPtr 
)

SndInputReadSync()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputResumeRecording()

ComponentResult SndInputResumeRecording ( ComponentInstance  self)

SndInputResumeRecording()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndInputSetDeviceInfo()

*t available *mac_os_x in version and later *ComponentResult SndInputSetDeviceInfo ( ComponentInstance  self,
OSType  infoType,
void *  infoData 
)

SndInputSetDeviceInfo()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

!TARGET_OS_MAC || TARGET_API_MAC_CARBON SOUND

◆ SndInputStopRecording()

ComponentResult SndInputStopRecording ( ComponentInstance  self)

SndInputStopRecording()

Non-Carbon CFM: not available
Carbon Lib: not available
Mac OS X: in version 10.0 and later

◆ SndManagerStatus()

OSErr SndManagerStatus ( short  theLength,
SMStatusPtr  theStatus 
)

SndManagerStatus Determine information about the Sound Manager.

You can use SndManagerStatus to determine the status of the
Sound Manager sound channel.
theLength should be the size in bytes of the SMStatus structure that
theStatus points to.
theStatus should be a pointer to an SMStatus structure which is filled out
with the status information.
Returns: an operating system Error Code .
noErr(0)No error
Note
You can call SndManagerStatus at interrupt time.
You can obtain information about a sound channel and about the
Sound Manager itself by calling the SndControl , SndChannelStatus ,
and SndManagerStatus functions. You can obtain the version numbers of
the Sound Manager , the MACE tools, and the sound input routines by
calling the SndSoundManagerVersion , MACEVersion , and
SPBVersion functions, respectively.
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndNewChannel()

OSErr SndNewChannel ( SndChannelPtr chan,
short  synth,
long  init,
SndCallBackUPP  userRoutine 
)

SndNewChannel()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndPauseFilePlay()

OSErr SndPauseFilePlay ( SndChannelPtr  chan)

SndPauseFilePlay Suspend asynchronous play from disk.

You can use SndPauseFilePlay in conjunction with SndStopFilePlay to
control play from disk on a sound channel. Note that this call can be made only
if your application has already called SndStartFilePlay with a valid sound
channel. This function cannot be used with a synchronous SndStartFilePlay
because, by definition, program control does not return to the caller until
after the sound has completely finished playing.
chan should be a pointer to a valid sound channel. If the channel is not
being used for play from disk, then SndPauseFilePlay returns the
result code channelNotBusy. If the channel is busy and paused, then
play from disk is resumed. If the channel is busy and the channel is
not paused, then play from disk is suspended..
Returns: an operating system Error Code .
noErr(0)No error
queueFull (-203)No room in the queue
badChannel (-205)Channel is corrupt or unusable
channelNotBusy (-211)Channel not currently used
Note
You can call SndPauseFilePlay at interrupt time.
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SndPlay()

OSErr SndPlay ( SndChannelPtr  chan,
SndListHandle  sndHandle,
Boolean  async 
)

SndPlay()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndPlayDoubleBuffer()

OSErr SndPlayDoubleBuffer ( SndChannelPtr  chan,
SndDoubleBufferHeaderPtr  theParams 
)

SndPlayDoubleBuffer()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SndRecord()

OSErr SndRecord ( ModalFilterUPP  filterProc,
Point  corner,
OSType  quality,
SndListHandle sndHandle 
)

SndRecord()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndRecordToFile()

OSErr SndRecordToFile ( ModalFilterUPP  filterProc,
Point  corner,
OSType  quality,
short  fRefNum 
)

SndRecordToFile()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SndSetInfo()

OSErr SndSetInfo ( SndChannelPtr  chan,
OSType  selector,
const void *  infoPtr 
)

SndSetInfo()

Non-Carbon CFM: in SoundLib 3.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndSetSysBeepState()

OSErr SndSetSysBeepState ( short  sysBeepState)

SndSetSysBeepState Set the state of the system alert sound..

You can use SndSetSysBeepState to set the state of the system alert sound.
sysBeepState is one of two states , either the sysBeepDisable or the
sysBeepEnable constant.
Returns: an operating system Error Code .
noErr(0)No error
paramErr (-50)A parameter is incorrect
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndSoundManagerVersion()

NumVersion SndSoundManagerVersion ( void  )

SndSoundManagerVersion Determine the version of the Sound Manager.

Sound Manager 2.0 and later, uses _SoundDispatch CALL_NOT_IN_CARBON

You can use SndSoundManagerVersion to determine the version of the
Sound Manager tools available on a machine.
Returns: a version number that contains the same information as in
the first 4 bytes of a 'vers' resource.
Note
You can call SndSoundManagerVersion at interrupt time.
You can obtain information about a sound channel and about the
Sound Manager itself by calling the SndControl , SndChannelStatus ,
and SndManagerStatus functions. You can obtain the version numbers of
the Sound Manager , the MACE tools, and the sound input routines by
calling the SndSoundManagerVersion , MACEVersion , and
SPBVersion functions, respectively.
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SndStartFilePlay()

OSErr SndStartFilePlay ( SndChannelPtr  chan,
short  fRefNum,
short  resNum,
long  bufferSize,
void *  theBuffer,
AudioSelectionPtr  theSelection,
FilePlayCompletionUPP  theCompletion,
Boolean  async 
)

SndStartFilePlay()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SndStopFilePlay()

OSErr SndStopFilePlay ( SndChannelPtr  chan,
Boolean  quietNow 
)

SndStopFilePlay()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SoundComponentAddSource()

ComponentResult SoundComponentAddSource ( ComponentInstance  ti,
SoundSource sourceID 
)

junction methods for the mixer, must be called at non-interrupt level SoundComponentAddSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentGetInfo()

ComponentResult SoundComponentGetInfo ( ComponentInstance  ti,
SoundSource  sourceID,
OSType  selector,
void *  infoPtr 
)

info methods SoundComponentGetInfo()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentGetSource()

ComponentResult SoundComponentGetSource ( ComponentInstance  ti,
SoundSource  sourceID,
ComponentInstance source 
)

SoundComponentGetSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentGetSourceData()

ComponentResult SoundComponentGetSourceData ( ComponentInstance  ti,
SoundComponentDataPtr sourceData 
)

SoundComponentGetSourceData()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentInitOutputDevice()

ComponentResult SoundComponentInitOutputDevice ( ComponentInstance  ti,
long  actions 
)

Sound Component Functions basic sound component functions SoundComponentInitOutputDevice()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentPauseSource()

ComponentResult SoundComponentPauseSource ( ComponentInstance  ti,
short  count,
SoundSource sources 
)

SoundComponentPauseSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentPlaySourceBuffer()

ComponentResult SoundComponentPlaySourceBuffer ( ComponentInstance  ti,
SoundSource  sourceID,
SoundParamBlockPtr  pb,
long  actions 
)

SoundComponentPlaySourceBuffer()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentRemoveSource()

ComponentResult SoundComponentRemoveSource ( ComponentInstance  ti,
SoundSource  sourceID 
)

SoundComponentRemoveSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentSetInfo()

ComponentResult SoundComponentSetInfo ( ComponentInstance  ti,
SoundSource  sourceID,
OSType  selector,
void *  infoPtr 
)

SoundComponentSetInfo()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentSetOutput()

ComponentResult SoundComponentSetOutput ( ComponentInstance  ti,
SoundComponentDataPtr  requested,
SoundComponentDataPtr actual 
)

SoundComponentSetOutput()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentSetSource()

ComponentResult SoundComponentSetSource ( ComponentInstance  ti,
SoundSource  sourceID,
ComponentInstance  source 
)

SoundComponentSetSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentStartSource()

ComponentResult SoundComponentStartSource ( ComponentInstance  ti,
short  count,
SoundSource sources 
)

control methods SoundComponentStartSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundComponentStopSource()

ComponentResult SoundComponentStopSource ( ComponentInstance  ti,
short  count,
SoundSource sources 
)

SoundComponentStopSource()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterBeginConversion()

OSErr SoundConverterBeginConversion ( SoundConverter  sc)

SoundConverterBeginConversion()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterClose()

OSErr SoundConverterClose ( SoundConverter  sc)

SoundConverterClose()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterConvertBuffer()

OSErr SoundConverterConvertBuffer ( SoundConverter  sc,
const void *  inputPtr,
unsigned long  inputFrames,
void *  outputPtr,
unsigned long *  outputFrames,
unsigned long *  outputBytes 
)

SoundConverterConvertBuffer()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterEndConversion()

OSErr SoundConverterEndConversion ( SoundConverter  sc,
void *  outputPtr,
unsigned long *  outputFrames,
unsigned long *  outputBytes 
)

SoundConverterEndConversion()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterFillBuffer()

OSErr SoundConverterFillBuffer ( SoundConverter  sc,
SoundConverterFillBufferDataUPP  fillBufferDataUPP,
void *  fillBufferDataRefCon,
void *  outputBuffer,
unsigned long  outputBufferByteSize,
unsigned long *  bytesWritten,
unsigned long *  framesWritten,
unsigned long *  outputFlags 
)

Sound Manager 3.6 and later calls, uses _SoundDispatch SoundConverterFillBuffer()

Non-Carbon CFM: in SoundLib 3.6 and later
Carbon Lib: in CarbonLib 1.1 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterGetBufferSizes()

OSErr SoundConverterGetBufferSizes ( SoundConverter  sc,
unsigned long  inputBytesTarget,
unsigned long *  inputFrames,
unsigned long *  inputBytes,
unsigned long *  outputBytes 
)

SoundConverterGetBufferSizes()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterGetInfo()

OSErr SoundConverterGetInfo ( SoundConverter  sc,
OSType  selector,
void *  infoPtr 
)

Sound Manager 3.3 and later calls, uses _SoundDispatch SoundConverterGetInfo()

Non-Carbon CFM: in SoundLib 3.3 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterOpen()

OSErr SoundConverterOpen ( const SoundComponentData inputFormat,
const SoundComponentData outputFormat,
SoundConverter sc 
)

SoundConverterOpen()

Non-Carbon CFM: in SoundLib 3.2 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundConverterSetInfo()

OSErr SoundConverterSetInfo ( SoundConverter  sc,
OSType  selector,
void *  infoPtr 
)

SoundConverterSetInfo()

Non-Carbon CFM: in SoundLib 3.3 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SoundManagerGetInfo()

OSErr SoundManagerGetInfo ( OSType  selector,
void *  infoPtr 
)

SoundManagerGetInfo()

Non-Carbon CFM: in SoundLib 3.6 and later
Carbon Lib: in CarbonLib 1.1 and later
Mac OS X: in version 10.0 and later

◆ SoundManagerSetInfo()

OSErr SoundManagerSetInfo ( OSType  selector,
const void *  infoPtr 
)

SoundManagerSetInfo()

Non-Carbon CFM: in SoundLib 3.6 and later
Carbon Lib: in CarbonLib 1.1 and later
Mac OS X: in version 10.0 and later

◆ SPBBytesToMilliseconds()

OSErr SPBBytesToMilliseconds ( long  inRefNum,
long *  byteCount 
)

SPBBytesToMilliseconds()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBCloseDevice()

OSErr SPBCloseDevice ( long  inRefNum)

SPBCloseDevice()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBGetDeviceInfo()

OSErr SPBGetDeviceInfo ( long  inRefNum,
OSType  infoType,
void *  infoData 
)

SPBGetDeviceInfo()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBGetIndexedDevice()

OSErr SPBGetIndexedDevice ( short  count,
Str255  deviceName,
Handle *  deviceIconHandle 
)

SPBGetIndexedDevice()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBGetRecordingStatus()

OSErr SPBGetRecordingStatus ( long  inRefNum,
short *  recordingStatus,
short *  meterLevel,
unsigned long *  totalSamplesToRecord,
unsigned long *  numberOfSamplesRecorded,
unsigned long *  totalMsecsToRecord,
unsigned long *  numberOfMsecsRecorded 
)

SPBGetRecordingStatus Obtain recording status information.

You can use SPBGetRecordingStatus to obtain recording status
information about a sound input device.
inRefNum the reference number of a sound input device
recordingStatus While the input device is recording, recordingStatus is
greater than 0. When the recording terminates without an
error, recordingStatus is equal to 0. If any error occurs
during the recording, recordingStatus is less than 0 and
contains an error code. If the recording is terminated by
calling SPBStopRecording , then recordingStatus
contains the abortErr result code.
meterLevel gives the current input signal level. Values returned are
in the range 0 to 255.
totalSamplesToRecord gives an indication of the total to record.
numberOfSamplesRecorded gives an indication of how many samples have been
recorded out of the total to record.
totalMsecsToRecord gives an indication of the total time to record
numberOfMsecsRecorded gives an indication of how much time has been recorded
out of the total to record
Returns: an operating system Error Code .
noErr(0)No error
siBadSoundInDevice (-221)Invalid sound input device
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBMillisecondsToBytes()

OSErr SPBMillisecondsToBytes ( long  inRefNum,
long *  milliseconds 
)

SPBMillisecondsToBytes()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBOpenDevice()

OSErr SPBOpenDevice ( ConstStr255Param  deviceName,
short  permission,
long *  inRefNum 
)

SPBOpenDevice()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBPauseRecording()

OSErr SPBPauseRecording ( long  inRefNum)

SPBPauseRecording Pause recording from the specified device.

CALL_NOT_IN_CARBON

The SPBPauseRecording function pauses recording from the device
specified by the inRefNum parameter. The recording must be asynchronous for
this call to have any effect
inRefNum must contain a valid reference number for an input device
Returns: an operating system Error Code .
noErr(0)No error
siBadSoundInDevice (-221)Invalid sound input device
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBRecord()

OSErr SPBRecord ( SPBPtr  inParamPtr,
Boolean  asynchFlag 
)

SPBRecord()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBRecordToFile()

OSErr SPBRecordToFile ( short  fRefNum,
SPBPtr  inParamPtr,
Boolean  asynchFlag 
)

SPBRecordToFile()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: not available
Mac OS X: not available

◆ SPBResumeRecording()

OSErr SPBResumeRecording ( long  inRefNum)

SPBResumeRecording Resume recording from the specified device.

The SPBResumeRecording function resumes recording from the device
specified by the inRefNum parameter. The recording must be asynchronous for
this call to have any effect.
inRefNum must contain a valid reference number for an input device
Returns: an operating system Error Code .
noErr(0)No error
siBadSoundInDevice (-221)Invalid sound input device
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBSetDeviceInfo()

OSErr SPBSetDeviceInfo ( long  inRefNum,
OSType  infoType,
void *  infoData 
)

SPBSetDeviceInfo()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBSignInDevice()

OSErr SPBSignInDevice ( short  deviceRefNum,
ConstStr255Param  deviceName 
)

CALL_NOT_IN_CARBON SPBSignInDevice()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBSignOutDevice()

OSErr SPBSignOutDevice ( short  deviceRefNum)

SPBSignOutDevice()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBStopRecording()

OSErr SPBStopRecording ( long  inRefNum)

SPBStopRecording Resume recording from the specified device.

The SPBStopRecording function stops recording from the device specified
by the inRefNum parameter. The recording must be asynchronous for this call
to have any effect. When you call SPBStopRecording , the completion routine
specified in the completionRoutine field of the sound input parameter block ,
SPB, is called and the error field of that parameter block is set to abortErr .
inRefNum must contain a valid reference number for an input device
Returns: an operating system Error Code .
noErr(0)No error
siBadSoundInDevice (-221)Invalid sound input device
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SPBVersion()

NumVersion SPBVersion ( void  )

Determine the version of the sound input routines.

Sound Input Manager routines, uses _SoundDispatch

You can use SPBVersion to determine the version of the sound input
routines available on a machine.
Returns: a version number that contains the same information as in the
first 4 bytes of a 'vers' resource.
Note
You can call SPBVersion at interrupt time.
You can obtain information about a sound channel and about the
Sound Manager itself by calling the SndControl , SndChannelStatus ,
and SndManagerStatus functions. You can obtain the version numbers of
the Sound Manager , the MACE tools, and the sound input routines by
calling the SndSoundManagerVersion , MACEVersion , and
SPBVersion functions, respectively.
Copyright: THINK Reference © 1991-1992 Symantec Corporation
Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SysBeep()

void SysBeep ( short  duration)

CALL_NOT_IN_CARBON

prototypes

Sound Manager routines SysBeep()

Non-Carbon CFM: in InterfaceLib 7.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ UnsignedFixedMulDiv()

UnsignedFixed UnsignedFixedMulDiv ( UnsignedFixed  value,
UnsignedFixed  multiplier,
UnsignedFixed  divisor 
)

UnsignedFixedMulDiv()

Non-Carbon CFM: in SoundLib 3.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: not available