In This Topic ▼

IltmmTVTuner::get_TuningSpace

Summary

Gets the current tuning space.

Syntax

#include "ltmm.h"

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

Parameters

IltmmTVTuner *pTV

Pointer to an IltmmTVTuner interface.

long *pVal

Pointer to a variable to be updated with the number of the current tuning space.

Returns

Value	Meaning
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.