CaptureInputs Class

The CaptureInputs Object contains a collections of the capture device inputs.

Object Model

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<DefaultMemberAttribute("Item")>
Public Class CaptureInputs 
   Implements System.Collections.Generic.IEnumerable(Of CaptureInput), System.Collections.IEnumerable

'Usage
 
Dim instance As CaptureInputs

[DefaultMemberAttribute("Item")]
public class CaptureInputs : System.Collections.Generic.IEnumerable<CaptureInput>, System.Collections.IEnumerable

[DefaultMemberAttribute("Item")]
public ref class CaptureInputs : public System.Collections.Generic.IEnumerable<CaptureInput>, System.Collections.IEnumerable

Remarks

The CaptureCtrl object uses the collection to enumerate and select audio and video capture inputs. A CaptureInputs object is not externally creatable and is only obtained through the parent object's CaptureCtrl.VideoInputs property.

Some video capture devices, like TV Tuners, also have audio inputs. For these devices, the CaptureInputs object controls both video and audio input selection. When a video device is selected, a list of matching video and audio inputs is created and held internally. For those video devices that don't have matching audio inputs, there is no need to be concerned about matching video and audio inputs. For more information on controlling video and audio inputs, see the Microsoft documentation for the IAMCrossbar interface.

To gain access to the video cross bar object, call CaptureCtrl.GetSubObject with CaptureObject.VideoCrossbar set for the ObjType parameter. The video cross bar property page can also be used to change the video and audio inputs. To display the property page, call the ShowDialog method with either CaptureDlg.VideoCrossbar or CaptureDlg.Capture set in the Dialog parameter. Changing the video and audio inputs using the cross bar property page may create an unmatched video-audio inputs pair. For example, if the video is set to come in from the 'TV Tuner', and the audio from the 'Audio Line-In', the video will not match the audio. This is a non-matching pair. To make sure the correct pair of inputs are matched after setting the property page, retrieve the closest valid pair of video and audio inputs from the NearestSelection property. Then, set the Selection property to the index obtained from the NearestSelection property to fix the potential problem. To determine whether the audio and video inputs match after using the cross bar property page, retrieve the current selection from the Selection. The index obtained will be -1 (provided the Count property is non-zero) if the selected pair do not match. However, if a video input is selected programmatically by setting the Selection property, there shouldn't be a problem with a non-matching pair of video and audio inputs; the right audio input will be selected automatically.

Requirements

Target Platforms

Reference

CaptureInputs Members
Leadtools.Multimedia Namespace