IC Imaging Control C++

Grabber::setInputChannel Method

Grabber::setInputChannel Method

Sets the input channel of the currently active video capture device.
bool setInputChannel( const tInputChannelItem& inChnItem );
bool setInputChannel( DWORD channel );
bool setInputChannel( const std::string& inputchannel );
bool setInputChannel( const std::wstring& inputchannel );

Parameter Description

Specifies the input channel. A list of available input channels may be obtained by calling Grabber::getAvailableInputChannels.


Specifies the input channel as a numerical index. The index is the position of the desired input channel in the list of available input channels, starting at 0.


Specifies the input channel as a string representation.

Return value:

true, if the channel could be changed successfully, false otherwise.


Not all devices provide channels. In order to determine whether the selection of an input channel is supported by the current device you can use Grabber::hasInputChannels.

See also: Grabber, Grabber::isInputChannelAvailableWithCurDev, Grabber::hasInputChannels, Grabber::getAvailableInputChannels, Grabber::getInputChannel

<< Grabber

Get in touch with us

About The Imaging Source

Established in 1990, The Imaging Source is one of the leading manufacturers of industrial cameras, video converters and embedded vision components for factory automation, quality assurance, medicine, science, security and a variety of other markets.

Our comprehensive range of cameras with USB 3.1, USB 3.0, USB 2.0, GigE, MIPI interfaces and other innovative machine vision products are renowned for their high quality and ability to meet the performance requirements of demanding applications.

ISO 9001:2015 certified MVTEC | Edge AI + Vision Alliance | EMVA

Contact us