In This Topic ▼

AutoTune Method

Summary

Fine tunes the specified channel by scanning for the most precise signal for that channel.

Syntax

C++

public int AutoTune( 
   int Channel 
)

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

public: 
int AutoTune(  
   int Channel 
)

Parameters

Channel
Channel number for which to scan.

Return Value

nonzero indicates found, zero indicates not found

Remarks

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.

Example

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; 
   } 
}

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

Requirements

Target Platforms

Reference

TVTuner Class

TVTuner Members

Download our FREE evaluation

Help Version 20.0.2020.4.2

Leadtools.MediaFoundation Assembly

Introduction

Getting Started

Namespaces

Leadtools.MediaFoundation Namespace

Leadtools.MediaFoundation.Common Namespace

Assemblies