Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sound Channels

SGSetSoundInputRate

The SGSetSoundInputRate function allows you to set the rate at which the sound channel obtains its sound data.

pascal ComponentResult SGSetSoundInputRate (SGChannel c,
                                             Fixed rate);

c

Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.

rate

Specifies the rate at which the sound channel is to acquire data. This parameter specifies the number of samples the sound channel is to generate per second. If the sound channel cannot support the rate you specify, it uses the closest available rate that it supports--you can use the SGGetSoundInputRate function, described in the next section, to retrieve the rate being used by the channel. Set this parameter to 0 to cause the sound channel to use its default rate.

You can determine the rates that are valid for a sound channel that uses a sound input device by calling the Sound Manager (see Inside Macintosh: More Macintosh Toolbox for more information about the Sound Manager).

RESULT CODES

cantDoThatInCurrentMode	-9402	Request invalid in current mode
deviceCantMeetRequest	-9408	Device cannot support grabber