Collapse All Expand All

IltmfTVTuner::get_TuningSpace

#include "ltmf.h"

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

 

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

Gets the current tuning space.

Parameter	Description
pTV	Pointer to an IltmfTVTuner 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.

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 IltmfTVTuner::put_TuningSpace.

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

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

Required DLLs and Libraries

LTMF 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:	IltmfTVTuner::put_TuningSpace, IltmfTVTuner::AutoTune, IltmfTVTuner::StoreAutoTune
Topics:	Media Foudation Function Group

Example

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