AutoTune Method

Visual Basic
C#
C++/CLI

'Declaration
 
Public Function AutoTune( _
   ByVal Channel As Integer _
) As Integer

'Usage
 
Dim instance As TVTuner
Dim Channel As Integer
Dim value As Integer
 
value = instance.AutoTune(Channel)

public int AutoTune( 
   int Channel
)

public:
int AutoTune( 
   int Channel
)

Parameters

Channel: Channel number for which to scan.

Return Value

nonzero indicates found, zero indicates not found

Fine tunes the specified channel by scanning for the most precise signal for that channel. This method maps the TV channel to a frequency and searches for the most precise frequency for this channel in the area. Calling this method for every channel in a region or country allows you to create a table of channel and frequency information. Once all channels in the region or country have been scanned, use StoreAutoTune to save the channel information. For more detailed information, refer to the Microsoft documentation for IAMTVTuner.AutoTune

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.MediaFoundation
Imports LeadtoolsMediaFoundationExamples.Fixtures

Public _result As Boolean = False
Public _form As CaptureCtrlForm = New CaptureCtrlForm()
Public Sub AutoTuneExample()
   ' reference the capture control
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl

   Try
      ' try set the analog video capture device, use your device name here
      If Not capturectrl.VideoDevices("Analog") Is Nothing Then
         capturectrl.VideoDevices("Analog").Selected = True
      End If

      ' reference the TV tuner interface
      Dim tvtuner As TVTuner = capturectrl.TVTuner

      ' Check if TV tuner is valid
      If Not tvtuner Is Nothing Then
         ' get the min and max channel info
         Dim minChan As Integer = tvtuner.ChannelMin
         Dim maxChan As Integer = tvtuner.ChannelMax

         ' select a channel between min and max to auto tune, do this for as many channels as desired
         Dim tuneChan As Integer = 25
         Dim ok As Integer = tvtuner.AutoTune(tuneChan)

         ' if we auto-tuned successfully, store the info
         If ok <> 0 Then
            ' store the auto tune information
            tvtuner.StoreAutoTune()
            ' set the result to what we expect
            _result = True
         End If
      End If
   Catch e1 As Exception
      _result = False
   End Try
End Sub

using Leadtools;
using Leadtools.MediaFoundation;
using LeadtoolsMediaFoundationExamples.Fixtures;

public bool _result = false;
public CaptureCtrlForm _form = new CaptureCtrlForm();
public void AutoTuneExample()
{
   // reference the capture control
   CaptureCtrl capturectrl = _form.CaptureCtrl;

   try
   {
      // try set the analog video capture device, use your device name here
      if (capturectrl.VideoDevices["Analog"] != null)
         capturectrl.VideoDevices["Analog"].Selected = true;

      // reference the TV tuner interface
      TVTuner tvtuner = capturectrl.TVTuner;

      // Check if TV tuner is valid
      if (tvtuner != null)
      {
         // get the min and max channel info
         int minChan = tvtuner.ChannelMin;
         int maxChan = tvtuner.ChannelMax;

         // select a channel between min and max to auto tune, do this for as many channels as desired
         int tuneChan = 25;
         int ok = tvtuner.AutoTune(tuneChan);

         // if we auto-tuned successfully, store the info
         if (ok != 0)
         {
            // store the auto tune information
            tvtuner.StoreAutoTune();
            // set the result to what we expect
            _result = true;
         }
      }
   }
   catch (Exception)
   {
      _result = false;
   }
}

Target Platforms

Reference

TVTuner Class
TVTuner Members