IltmmTVTuner::AutoTune

#include "ltmm.h"

C Syntax

HRESULT IltmmTVTuner_AutoTune(pTV, Channel, pVal)

C++ Syntax

HRESULT AutoTune(Channel, pVal)

 

IltmmTVTuner *pTV;

/* pointer to an interface */

long Channel;

/* channel */

long *pVal;

/* pointer to a variable */

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

Parameter

Description

pTV

Pointer to an IltmmTVTuner interface.

Channel

Number of the channel to "fine tune".

pVal

Pointer to a variable to be updated with a value that indicates whether the signal was found. A nonzero value indicates the signal was found. Zero indicates the signal was not found.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This function maps the TV channel to a frequency and searches for the most precise frequency for this channel, in the area. Calling this function 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 IltmmTVTuner::StoreAutoTune to save the channel information.

For more detailed information, refer to the Microsoft documentation for IAMTVTuner::AutoTune at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/iamtvtunerautotune.asp.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Elements:

IltmmTVTuner::StoreAutoTune, IltmmTVTuner::get_TuningSpace, IltmmTVTuner::put_TuningSpace

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmTVTuner::AutoTune Example for C.

For a C++ example, refer to IltmmTVTuner::AutoTune Example for C++.