Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Devices

SGAppendDeviceListToMenu

The SGAppendDeviceListToMenu function allows you to place a list of device names into a specified menu.

pascal ComponentResult SGAppendDeviceListToMenu 
                           (SeqGrabComponent s, 
                           SGDeviceList list, MenuHandle mh);

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.

list

Defines a pointer to a device list structure pointer. The sequence grabber appends the name of each device in the list to the menu specified by the mh parameter. If the sgDeviceNameFlagDeviceUnavailable flag is set to 1 for a device in the list, the sequence grabber disables the menu item corresponding to that device.

mh

Specifies the menu to which the device names are to be appended.

DESCRIPTION

You may use the SGAppendDeviceListToMenu function to present a list of valid devices to the user. The user may then select a device from the list. You can assign
that device to a channel by calling the SGSetChannelDevice function. Note that, if you choose to have the sequence grabber check the availability of each device (by setting the sgDeviceListDontCheckAvailability flag to 0 with the SGGetChannelDeviceList function), the sequence grabber will disable menu
items that correspond to unavailable devices. This prevents the user from selecting a device that cannot be used.

RESULT CODE

paramErr

-50

Invalid parameter value

SEE ALSO

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

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