Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Devices

SGSetChannelDevice

The SGSetChannelDevice function allows you to assign a device to a channel.

pascal ComponentResult SGSetChannelDevice (SGChannel c, 
                                             StringPtr name);

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.

name

Points to the device's name string. This name is contained in the name field of the appropriate device name structure in the device list.

DESCRIPTION

When you call the SGSetChannelDevice function, the sequence grabber channel tries to use the specified device, in place of the device currently in use. You must obtain the device name from the channel's device list.

RESULT CODES

paramErr	-50	Invalid parameter value
deviceCantMeetRequest	-9408	Device cannot support grabber

SEE ALSO

You obtain the device list by calling the SGGetChannelDeviceList function, which is described on page 5-70.

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