SGGetSoundInputParameters(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sound Channels

SGGetSoundInputParameters
The SGGetSoundInputParameters function allows you to retrieve some parameters that relate to sound recording.
pascal ComponentResult SGGetSoundInputParameters (SGChannel c,
                                        short *sampleSize,
                                        short *numChannels,
                                        OSType *compressionType);
c
Identifies the channel for this operation. You provide your
connection identifier. You connect to a channel component by calling the SGNewChannel or SGNewChannelFromComponent function, discussed on page 5-29 and page 5-30, respectively.
sampleSize
Contains a pointer to a field to receive the sample size. The sequence grabber sets this field to 8 for 8-bit sound; it sets the field to 16 for 16-bit sound.
numChannels

Contains a pointer to a field to receive the number of sound channels used by the sound sample. The sequence grabber sets this field to 1 for monaural sounds; it sets the field to 2 for stereo sounds.
compressionType

Contains a pointer to a field that is to receive the format of the sound data. The following values may be returned:
'raw'
Sound samples are uncompressed, in offset-binary format (that is, sample data values range from 0 to 255).
'MAC3'
Sound samples have been compressed by the Sound Manager at a ratio of 3:1.
'MAC6'
Sound samples have been compressed by the Sound Manager at a ratio of 6:1.

DESCRIPTION
You may use the SGGetSoundInputParameters function to retrieve many parameters relating to sound recording. If you set any of the sound parameters to nil, the sequence grabber does not return that value.