Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sequence Grabber Settings

SGSetSettings

The SGSetSettings function allows you to configure a sequence grabber and its channels.

pascal ComponentResult SGSetSettings (SeqGrabComponent s,
                                       UserData ud, long flags);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

ud

Specifies a Movie Toolbox user data list that contains the configuration information to be used by the sequence grabber.

flags

Reserved for Apple. Set this parameter to 0.

DESCRIPTION

The SGSetSettings function allows you to configure a sequence grabber. You
provide this configuration information in a Movie Toolbox user data list. Typically, you obtain this configuration data from the SGGetSettings function, which is discussed in the previous section.

Note that the sequence grabber disposes of any of its current channels before applying this configuration information. It then opens connections to new channels as appropriate.

You can restore saved settings by using the Movie Toolbox's NewUserDataFromHandle function.

RESULT CODES

noDeviceForChannel	-9400	Channel component cannot find its device
couldntGetRequiredComponent	-9405	Component not found
deviceCantMeetRequest	-9408	Device cannot support grabber

SEE ALSO

You may set the configuration of one channel component by using the SGSetChannelSettings function (described on page 5-50).

You may use the SGGetIndChannel function (described on page 5-31) to obtain information about each channel that the sequence grabber is using as a result of applying this new configuration.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help