Carbon


SCStatus

Header: Sound.h

struct SCStatus {
    UnsignedFixed scStartTime; 
    UnsignedFixed scEndTime; 
    UnsignedFixed scCurrentTime; 
    Boolean scChannelBusy; 
    Boolean scChannelDisposed; 
    Boolean scChannelPaused; 
    Boolean scUnused; 
    UInt32 scChannelAttributes; 
    SInt32 scCPULoad;
};
typedef SCStatus SCStatusPtr;

Field descriptions

scStartTime

If the Sound Manager is playing from disk through the specified sound channel, then scStartTime is the starting time in seconds from the beginning of the sound for the play from disk. Otherwise, scStartTime is 0.

scEndTime

If the Sound Manager is playing from disk through the specified sound channel, then scEndTime is the ending time in seconds from the beginning of the sound for the play from disk. Otherwise, scEndTime is 0.

scCurrentTime

If the Sound Manager is playing from disk through the specified sound channel, then scCurrentTime is the current time in seconds from the beginning of the disk play. Otherwise, scCurrentTime is 0. The Sound Manager updates the value of this field only periodically, and you should not rely on the accuracy of its value.

scChannelBusy

If the specified channel is currently processing sound commands, then scChannelBusy is TRUE; otherwise, scChannelBusy is FALSE.

scChannelDisposed

Reserved for use by Apple Computer, Inc.

scChannelPaused

If the Sound Manager is playing from disk through the specified sound channel and the play from disk is paused, then scChannelPaused is TRUE; otherwise, scChannelPaused is FALSE. This field is also TRUE if the channel was paused with the pauseCmd sound command.

scUnused

Reserved for use by Apple Computer, Inc.

scChannelAttributes

The current attributes of the specified channel. These attributes are in the channel initialization parameters format. The value returned in this field is always identical to the value passed in the init parameter to SndNewChannel. See “Channel Initialization Constants” for a description of the constants which you can use to mask out these attributes.

scCPULoad

The CPU load for the specified channel. You should not rely on the value in this field.

To obtain information about a sound channel, you can pass a pointer to a sound channel status structure to the SndChannelStatus function. The SCStatus data type defines a sound channel status structure.

You should use this data structure only if you need to access this information or to customize sound play.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)