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.

Elements:	IltmmTVTuner::StoreAutoTune, IltmmTVTuner::get_TuningSpace, IltmmTVTuner::put_TuningSpace
Topics:	Multimedia Function Group