CaptureInputs Class

Summary

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

Syntax
C#
VB
C++
[DefaultMemberAttribute("Item")] 
public class CaptureInputs : IEnumerable<CaptureInput>, IEnumerable, IDisposable 
<DefaultMemberAttribute("Item")> 
Public Class CaptureInputs  
   Implements System.Collections.Generic.IEnumerable(Of CaptureInput), System.Collections.IEnumerable, System.IDisposable  
[DefaultMemberAttribute("Item")] 
public ref class CaptureInputs : public System.Collections.Generic.IEnumerable<CaptureInput>, System.Collections.IEnumerable, System.IDisposable   
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

Help Version 20.0.2019.11.25
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Multimedia Assembly