IAMTuner 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 IAMTuner interface controls a TV tuner. This interface is the base class for the IAMTVTuner interface, which inherits all of the IAMTuner methods. For more information on controlling a TV tuner using Microsoft DirectShow, see the IAMTVTuner documentation.
Inheritance
The IAMTuner interface inherits from the IUnknown interface. IAMTuner also has these types of members:
Methods
The IAMTuner interface has these methods.
| IAMTuner::ChannelMinMax The ChannelMinMax method retrieves the highest and lowest channels available. |
| IAMTuner::get_Channel The get_Channel method retrieves the channel to which the tuner is set. |
| IAMTuner::get_CountryCode The get_CountryCode method retrieves the country/region code that establishes the current channel-to-frequency mapping. |
| IAMTuner::get_Mode The get_Mode method retrieves the current mode on a multifunction tuner. |
| IAMTuner::get_TuningSpace The get_TuningSpace method retrieves the tuning space. |
| IAMTuner::GetAvailableModes The GetAvailableModes method retrieves the tuner's supported modes. |
| IAMTuner::Logon The Logon method logs a user onto the system. |
| IAMTuner::Logout The Logout method logs out the current user. |
| IAMTuner::put_Channel The put_Channel method sets the TV channel. |
| IAMTuner::put_CountryCode The put_CountryCode method sets the country/region code to establish the frequency to use. |
| IAMTuner::put_Mode The put_Mode method sets a multifunction tuner to the specified mode. |
| IAMTuner::put_TuningSpace The put_TuningSpace method sets a storage index for regional channel-to-frequency mappings. |
| IAMTuner::RegisterNotificationCallBack The RegisterNotificationCallBack method enables an object to receive event notifications when the tuner changes state. |
| IAMTuner::SignalPresent The SignalPresent method retrieves the strength of the signal on a given channel. |
| IAMTuner::UnRegisterNotificationCallBack The UnRegisterNotificationCallBack method unregisters an object for event notifications. (IAMTuner.UnRegisterNotificationCallBack) |
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) |