SGGetChannelSettings(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sequence Grabber Settings

SGGetChannelSettings
The SGGetChannelSettings function retrieves the current settings of one channel used by the sequence grabber. The sequence grabber places this configuration information into a Movie Toolbox user data list.
pascal ComponentResult SGGetChannelSettings (SeqGrabComponent s, 
                                             SGChannel c,
                                             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.
c
Identifies the channel for this operation. You pass 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.
ud
Contains a pointer. The sequence grabber returns a pointer to a Movie Toolbox user data list that contains the configuration information.
flags
Reserved for Apple. Set this parameter to 0.

DESCRIPTION
The SGGetChannelSettings function allows you to retrieve the configuration information for a single channel component. The channel component stores
that information in a Movie Toolbox user data list. You may subsequently use the SGSetChannelSettings function to reconfigure the channel (this function is described next).

RESULT CODES
Memory Manager errors

SEE ALSO
You may retrieve the configuration of the entire sequence grabber, including all of its channels, by using the SGGetSettings function, described on page 5-47.