ITuneRequestInfo Interface
| Microsoft DirectShow 9.0 |
ITuneRequestInfo Interface
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.
In addition to the methods inherited from IUnknown, the ITuneRequestInfo interface exposes the following methods.
| Method | Description |
| CreateComponentList | 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. |
| GetComponentData | Fills in all network-specific component data for the existing Components collection on the specified tune request. |
| GetLocatorData | Provides channel/program locator information for the specified tune request. |
| GetNextLocator | Creates a new tune request with locator information for the next transport stream on the network. |
| GetNextProgram | Creates a new tune request with channel/program locator information for the next service on the current transport stream. |
| GetPreviousLocator | Creates a new tune request with locator information for the previous transport stream on the network. |
| GetPreviousProgram | Creates a new tune request with locator information for the previous service on the current transport stream. |
Requirements
Header: Include Bdatif.h.
See Also