LEADTOOLS Multimedia (Leadtools.Multimedia assembly) Send comments on this topic. | Back to Introduction | Help Version 17.0.3.22
CaptureInputs Class
See Also  Members  
Leadtools.Multimedia Namespace : CaptureInputs Class



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

Object Model

CaptureInputs ClassCaptureInput Class

Syntax

Visual Basic (Declaration) 
<DefaultMemberAttribute("Item")>
Public Class CaptureInputs 
   Implements IEnumerable(Of CaptureInput)IEnumerableIEnumerator 
Visual Basic (Usage)Copy Code
Dim instance As CaptureInputs
C# 
[DefaultMemberAttribute("Item")]
public class CaptureInputs : IEnumerable<CaptureInput>IEnumerableIEnumerator  
C++/CLI 
[DefaultMemberAttribute("Item")]
public ref class CaptureInputs : public IEnumerable<CaptureInput>IEnumerableIEnumerator  

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 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.

Inheritance Hierarchy

System.Object
   Leadtools.Multimedia.CaptureInputs

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also