Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 2 - Sound Manager / Sound Manager Reference
Sound Manager Routines / Obtaining Information


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.

SndChannelStatus

You can use the SndChannelStatus function to determine the status of a sound channel.

FUNCTION SndChannelStatus (chan: SndChannelPtr; 
                              theLength: Integer; 
                              theStatus: SCStatusPtr): OSErr;
chan
A pointer to a valid sound channel.
theLength
The size in bytes of the sound channel status record. You should set this field to SizeOf(SCStatus).
theStatus
A pointer to a sound channel status record.
DESCRIPTION
If the SndChannelStatus function executes successfully, the fields of the record specified by theStatus accurately describe the sound channel specified by chan.

SPECIAL CONSIDERATIONS
You can call the SndChannelStatus function at interrupt time.

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

RESULT CODES
noErr0No error
paramErr-50A parameter is incorrect
badChannel-205Channel is corrupt or unusable
SEE ALSO
For information on the structure of a sound channel status record, see "Sound Channel Status Records" on page 2-101.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996