ITuneRequestInfo interface (bdatif.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 ITuneRequestInfo interface is implemented on the BDA MPEG2 Transport Information Filter (TIF) and is used by the Network Provider. When the Network Provider receives a tune request, it is not guaranteed that all the necessary locator information will be present in the locator object associated with the tune request. If information is missing, the Network Provider uses this interface to instruct the TIF to fill in the locator data. Similarly, a tune request might not contain a complete list of all the components (substreams) available on the service at a given time. After the Network Provider has tuned to a service, it can ask the TIF to fill in the component information associated with the tune request. An application can then re-examine the tune request after it has been submitted, and compare it to the list of default preferred component types to determine whether to tune to a particular audio stream, or inform the user of any substreams that were not mentioned in the EPG data. For more information, see ITuningSpace::get_DefaultPreferredComponentTypes.
If the TIF is not able to provide the locator data for the transport stream, it must provide the default locator for the tuning space associated with the tune request.
Inheritance
The ITuneRequestInfo interface inherits from the IUnknown interface. ITuneRequestInfo also has these types of members:
Methods
The ITuneRequestInfo interface has these methods.
| ITuneRequestInfo::CreateComponentList The CreateComponentList method creates a new Components collection for the tune request, and fills it in with all network-specific data after the receiver has tuned to the service. |
| ITuneRequestInfo::GetComponentData The GetComponentData method fills in all network-specific component data for the existing Components collection on the specified tune request. |
| ITuneRequestInfo::GetLocatorData The GetLocatorData method fills in channel or program locator information for the specified tune request. |
| ITuneRequestInfo::GetNextLocator The GetNextLocator method creates a new tune request with locator information for the next transport stream on the network. |
| ITuneRequestInfo::GetNextProgram The GetNextProgram method creates a new tune request with channel or program locator information for the next service. |
| ITuneRequestInfo::GetPreviousLocator The GetPreviousLocator method creates a new tune request with locator information for the previous transport stream. |
| ITuneRequestInfo::GetPreviousProgram The GetPreviousProgram method creates a new tune request with channel or program locator information for the previous service. |
Remarks
To declare the interface identifier (IID) for this interface, use the __uuidof operator: __uuidof(ITuneRequestInfo).
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | bdatif.h |