In This Topic ▼

Name Property

Summary

Gets the name of the capture input.

Syntax

C++

public string Name {get;}

Public ReadOnly Property Name As String

public: 
property String^ Name { 
   String^ get(); 
}

Property Value

the audio input name.

Remarks

This property is used to uniquely identify the CaptureSubType object. This string is the same as the string in the FriendlyName property. A program can save this value to persistent storage and use it later with the CaptureInputs.IndexOf and CaptureInputs.Selection methods to restore the input selection.

Example

using Leadtools; 
using Leadtools.MediaFoundation; 
using LeadtoolsMediaFoundationExamples.Fixtures; 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void CaptureInputsExample() 
{ 
   string inputName, inputFriendlyName; 
   int selection; 
 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   // select a video device, use your device name here instead of Analog 
   if (capturectrl.VideoDevices["Analog"] == null) 
      throw new Exception("No Analog video tuner device available"); 
 
   capturectrl.VideoDevices["Analog"].Selected = true; 
 
   // get the audio inputs object 
   CaptureInputs inputs = capturectrl.VideoInputs; 
 
   try 
   { 
      // select an input by name if possible 
      if (inputs["Video Composite"] != null) 
         inputs["Video Composite"].Selected = true; 
 
      // get the current selected input 
      selection = inputs.Selection; 
 
      foreach (CaptureInput ci in inputs) 
      { 
         // get the inputs properties 
         inputName = ci.Name; 
         inputFriendlyName = ci.FriendlyName; 
 
         // if we found the video tuner input 
         if (inputFriendlyName == "Video Tuner") 
         { 
            // select it and break 
            ci.Selected = true; 
            break; 
         } 
      } 
 
      // set the result to what we expect 
      _result = (selection != inputs.Selection); 
 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
}

Imports Leadtools 
Imports Leadtools.MediaFoundation 
Imports LeadtoolsMediaFoundationExamples.Fixtures 
 
Public _result As Boolean = False 
Public _form As CaptureCtrlForm = New CaptureCtrlForm() 
 
Public Sub CaptureInputsExample() 
   Dim inputName, inputFriendlyName As String 
   Dim selection As Integer 
 
   ' reference the capture control 
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl 
 
   ' select a video device, use your device name here instead of Analog 
   If capturectrl.VideoDevices("Analog") Is Nothing Then 
      Throw New Exception("No Analog video tuner device available") 
   End If 
 
   capturectrl.VideoDevices("Analog").Selected = True 
 
   ' get the audio inputs object 
   Dim inputs As CaptureInputs = capturectrl.VideoInputs 
 
   Try 
      ' select an input by name if possible 
      If Not inputs("Video Composite") Is Nothing Then 
         inputs("Video Composite").Selected = True 
      End If 
 
      ' get the current selected input 
      selection = inputs.Selection 
 
      For Each ci As CaptureInput In inputs 
         ' get the inputs properties 
         inputName = ci.Name 
         inputFriendlyName = ci.FriendlyName 
 
         ' if we found the video tuner input 
         If inputFriendlyName = "Video Tuner" Then 
            ' select it and break 
            ci.Selected = True 
            Exit For 
         End If 
      Next ci 
 
      ' set the result to what we expect 
      _result = (selection <> inputs.Selection) 
 
   Catch e1 As Exception 
      _result = False 
   End Try 
End Sub

Requirements

Target Platforms

Reference

CaptureInput Class

CaptureInput Members

Download our FREE evaluation

Help Version 21.0.2021.7.2

Leadtools.MediaFoundation Assembly

Introduction

Getting Started

Namespaces

Leadtools.MediaFoundation Namespace

Leadtools.MediaFoundation.Common Namespace

Assemblies