Inside Macintosh: Sound /

Chapter 2 - Sound Manager / Sound Manager Reference

Sound Manager Routines / Obtaining Information

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 macro	Selector
_SoundDispatch	$00100008

RESULT CODES

noErr	0	No error
paramErr	-50	A parameter is incorrect
badChannel	-205	Channel 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.