ITuner Interface

  • Article

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 Microsoft® Windows® 9.x or Windows 2000 will use this interface. On Windows XP, the Video Control handles all tuning interactions with the Network Provider.

Methods

The ITuner interface inherits the methods of the IUnknown interface.

In addition, ITuner defines the following methods.

Method Description

EnumTuningSpaces

Creates a collection of the tuning spaces preferred by this implementation.

get_PreferredComponentTypes

Gets the collection of ComponentType objects used for default component selection.

get_SignalStrength

Retrieves the Network Provider-specific signal strength metric.

get_TuneRequest

Gets the tune request currently in effect for the Network Provider.

get_TuningSpace

Gets the tuning space currently in effect for the Network Provider.

put_PreferredComponentTypes

Sets the collection of ComponentType objects used for default component selection.

put_TuneRequest

Sets the tune request for the Network Provider.

put_TuningSpace

Sets the tuning space for the Network Provider.

TriggerSignalEvents

Enables the tuner to raise an event when the status of the signal changes.

Validate

Returns a value indicating that the tune request can be carried out.

Requirements

Header Declared in Bdaiface.h.

See Also

BDA Interfaces

Send comments about this topic to Microsoft

Build date: 12/4/2008