Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 2 - Sound Manager / Sound Manager Reference
Sound Manager Routines / Sending Commands to a Sound Channel


Legacy Documentclose button

Important: Inside Macintosh: Sound is deprecated as of Mac OS X v10.5. For new audio development in Mac OS X, use Core Audio. See the Audio page in the ADC Reference Library.

SndDoImmediate

You can use the SndDoImmediate function to place a sound command in front of a sound channel's command queue.

FUNCTION SndDoImmediate (chan: SndChannelPtr; cmd: SndCommand): 
                           OSErr;
chan
A pointer to a sound channel.
cmd
A sound command to be sent to the channel specified in the chan parameter.
DESCRIPTION
The SndDoImmediate function operates much like SndDoCommand, except that it bypasses the existing command queue of the sound channel and sends the specified command directly to the Sound Manager for immediate processing. This routine also overrides any waitCmd, pauseCmd, or syncCmd commands that might have already been processed. However, other commands already received by the Sound Manager will not be interrupted by the SndDoImmediate function (although a quietCmd command sent via SndDoImmediate will quiet a sound already playing).

SPECIAL CONSIDERATIONS
Whether SndDoImmediate moves memory depends on the particular sound command you're sending it. Most of the available sound commands do not cause SndDoImmediate to move memory and can therefore be issued at interrupt time. Moreover, you can sometimes safely send commands at interrupt time that would otherwise cause memory to move if you've previously issued the soundCmd sound command to preconfigure the channel at noninterrupt time.

RESULT CODES
noErr0No error
badChannel-205Channel is corrupt or unusable
SEE ALSO
For an example of a routine that uses the SndDoImmediate function, see Listing 2-4 on page 2-26.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996