ITuneRequest 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 ITuneRequest interface is the base interface for all tune requests. Each tune request object supports a network-specific interface that derives from ITuneRequest, such as IATSCChannelTuneRequest or IDVBTuneRequest.
This interface is used 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 some type of third-party storage mechanism.
Inheritance
The ITuneRequest interface inherits from the IDispatch interface. ITuneRequest also has these types of members:
Methods
The ITuneRequest interface has these methods.
| ITuneRequest::Clone The Clone method returns a new copy of this tune request. |
| ITuneRequest::get_Components The get_Components method retrieves the components contained in this tune request. |
| ITuneRequest::get_Locator The get_Locator method is called from the Network Provider to get the ILocator object associated with the requested broadcast. |
| ITuneRequest::get_TuningSpace The get_TuningSpace method retrieves the tuning space that was used to create this tune request. |
| ITuneRequest::put_Locator The put_Locator method is called from the Network Provider to set the ILocator object associated with the requested broadcast. |
Remarks
To declare the interface identifier (IID) for this interface, use the __uuidof operator: __uuidof(ITuneRequest).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | tuner.h |