IRegisterTuner Interface

Microsoft DirectShow 9.0

IRegisterTuner Interface

This feature is expected to be available on a future version of the Windows operating system.

The IRegisterTuner interface registers an apartment-threaded tuner with the tuner marshaller and registers the tuner marshaller with the graph service provider.

A common scenario that uses the video control involves a physical remote control sending infrared commands to a set-top box. The set-top box can be plugged into an auxiliary input or into the radio frequency (RF) tuner on the playback device. The analog tuner in the video control must be tuned to the input channel to receive the signal, but the content is actually on a different channel. Some filters need the actual content channel; they query ITuner to retrieve it.

However, an object outside the filter graph and the video control may be doing the actual tuning. If the external object is apartment-model threaded, synchronization issues may occur because ITuner can be called on any thread. The tuner marshaller is a utility object that simplifies this situation by storing the apartment model interface pointer and registering itself instead. Whenever the tuner marshaller ITuner interface is called, the tuner marshaller does the correct marshalling and passes the call to the external apartment-model object. The tuner marshaller also handles registering with the graph service provider.

In addition to the methods inherited from IUnknown, the IRegisterTuner interface exposes the following methods.

Method Description
Register Registers an apartment-threaded tuner.
Unregister Unregisters an apartment-threaded tuner.


Header: Include bdaiface.h.

See Also