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: |
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++.