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 at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/iamtunerget_tuningspace.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::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++.