SGDisposeChannel
The SGDisposeChannel function removes a channel from a sequence grabber component.
pascal ComponentResult SGDisposeChannel
(SeqGrabComponent s, SGChannel c);
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
- Specifies the reference that identifies the channel you want to close. You obtain this reference from the
SGNewChannel function, described in the previous section.
DESCRIPTION
You can use this function to remove a channel that you are no longer using. However, you cannot dispose of a channel that is currently active--if you are recording or previewing data, this function returns a nonzero result code.
RESULT CODE
| badSGChannel | -9406 | Invalid channel specified |
SEE ALSO
The sequence grabber component automatically disposes of any open channels when you close your connection to the component, so you do not need to call this function prior to calling the Component Manager's CloseComponent function.