ITuner interface (tuner.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The ITuner interface is implemented on the Microsoft BDA Network Provider filters. It provides methods for passing tune requests down to the hardware device and receiving current tuning settings. Generally, applications should use the derived interface IScanningTuner instead of ITuner.

Note��Only applications that are intended to run on Windows�2000 should use this interface. Starting in Windows�XP, the Video Control handles all tuning interactions with the Network Provider.

Inheritance

The ITuner interface inherits from the IUnknown interface. ITuner also has these types of members:

Methods

The ITuner interface has these methods.

 
ITuner::EnumTuningSpaces

The EnumTuningSpaces method creates a collection of tuning spaces preferred by this implementation.
ITuner::get_PreferredComponentTypes

The get_PreferredComponentTypes method gets the collection of ComponentType objects used for default component selection.
ITuner::get_SignalStrength

The get_SignalStrength method retrieves the Network Provider-specific signal strength metric.
ITuner::get_TuneRequest

The get_TuneRequest method gets the tune request currently in effect for the Network Provider.
ITuner::get_TuningSpace

The get_TuningSpace method gets the tuning space currently in effect for the Network Provider.
ITuner::put_PreferredComponentTypes

The put_PreferredComponentTypes method sets the collection of ComponentType objects used for default component selection.
ITuner::put_TuneRequest

The put_TuneRequest method sets the tune request currently in effect for the Network Provider.
ITuner::put_TuningSpace

The put_TuningSpace method sets the tuning space for the Network Provider.
ITuner::TriggerSignalEvents

The TriggerSignalEvents method enables the tuner to raise an event when the status of the signal changes.
ITuner::Validate

The Validate method returns a value indicating that the tune request can be carried out.

Remarks

To declare the interface identifier (IID) for this interface, use the __uuidof operator: __uuidof(ITuner).

Requirements

   
Target Platform Windows
Header tuner.h

See also

BDA Interfaces