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.
