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)