IAMTVTuner interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The IAMTVTuner interface controls a TV tuner. The TV Tuner filter implements this interface. Applications can use this interface to set TV channels and to get or set information about their frequencies, and to determine what analog video standards your TV tuner card supports.
The interface supports tuners for analog broadcast television and AM/FM radio. It supports tuners with multiple input pins, to enable multiple devices and multiple transmission types. The TV Tuner filter supports worldwide tuning coverage. It maps TV channels to specific frequencies through the IAMTuner::put_Channel and IAMTVTuner::AutoTune methods. These methods handle the details of the conversion, so that the hardware driver receives an exact frequency.
Inheritance
The IAMTVTuner interface inherits from IAMTuner. IAMTVTuner also has these types of members:
Methods
The IAMTVTuner interface has these methods.
| IAMTVTuner::AutoTune The AutoTune method scans for a precise signal on the channel's frequency. |
| IAMTVTuner::get_AudioFrequency The get_AudioFrequency method retrieves the currently tuned audio frequency. |
| IAMTVTuner::get_AvailableTVFormats The get_AvailableTVFormats method retrieves all the analog video TV standards that the tuner supports. |
| IAMTVTuner::get_ConnectInput The get_ConnectInput method retrieves the hardware tuner input connection. |
| IAMTVTuner::get_InputType The get_InputType method retrieves the input type set in IAMTVTuner::put_InputType. |
| IAMTVTuner::get_NumInputConnections The get_NumInputConnections method retrieves the number of TV sources plugged into the tuner filter. |
| IAMTVTuner::get_TVFormat The get_TVFormat method retrieves the current analog video TV standard in use. |
| IAMTVTuner::get_VideoFrequency The get_VideoFrequency method retrieves the current video frequency. |
| IAMTVTuner::put_ConnectInput The put_ConnectInput method sets the hardware tuner input connection. |
| IAMTVTuner::put_InputType The put_InputType method sets the tuner input type (cable or antenna). |
| IAMTVTuner::StoreAutoTune The StoreAutoTune method saves the fine-tuning information for all channels. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |