Collapse All Expand All

IltmmTVTuner::get_TuningSpace

#include "ltmm.h"

C Syntax	HRESULT IltmmTVTuner_get_TuningSpace(pTV, pVal)
C++ Syntax	HRESULT get_TuningSpace(pVal)

 

IltmmTVTuner *pTV;	/* pointer to an interface */
long *pVal;	/* pointer to a variable */

Gets the current tuning space.

Parameter	Description
pTV	Pointer to an IltmmTVTuner interface.
pVal	Pointer to a variable to be updated with the number of the current tuning space.

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

A tuning space is a set of information about the available channels and the channel to frequency mapping, which can identify a particular network provider or broadcast source. Multiple tuning spaces can be determined and stored for use in multiple areas.

This function gets the number of the current tuning space being used by the tuner.

To set the index of the current tuning space used by the tuner, call IltmmTVTuner::put_TuningSpace.

To get the most precise frequency for a particular channel, use IltmmTVTuner::AutoTune. Once the frequencies for all channels have been found using AutoTune, this information can be stored by calling IltmmTVTuner::StoreAutoTune.

For more detailed information, refer to the Microsoft documentation for IAMTuner::get_TuningSpace.

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.

Platforms

Win32, x64

See Also

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

Example

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

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