Microsoft DirectX 8.1 (C++)

ITuneRequest Interface

The ITuneRequest interface is the base class for derived interfaces such as IChannelTuneRequest, IATSCChannelTuneRequest and IDVBTuneRequest. These methods are used (through the derived interfaces) by any application that creates tune requests, such as a Guide Store loader. A tune request must be associated with a specific network type. When a tune request is submitted, the derived interfaces are used by the Network Provider to extract the tuning information required by the hardware. All tune request objects also support IPersistPropertyBag, which enables them to be persisted in the Guide Store or any other third-party storage mechanism.

In addition to the methods inherited from IDispatch, the ITuneRequest interface exposes the following methods.

Method Description
Clone Returns a new copy of this tune request.
get_Components Retrieves the components contained in this tune request.
get_Locator Called from the Network Provider to get the ILocator object associated with the requested broadcast.
get_TuningSpace Retrieves the tuning space that was used to create this tune request.
put_Locator Called from the Network Provider to set the ILocator object associated with the requested broadcast.