ITuneRequestInfo::CreateComponentList Method

Article
01/07/2009

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.

Syntax

HRESULT CreateComponentList(
  [in]  ITuneRequest *pCurrentRequest
);

Parameters

pCurrentRequest [in]
Pointer to the ITuneRequest interface on the tune request.

Return Value

The method returns an HRESULT. Possible values include those in the following table.

Return code	Description
S_OK	The method succeeded and new data was added.
S_FALSE	The method succeeded but no new data was added.
E_FAIL	No data could be acquired.

Remarks

After the Network Provider has acquired the correct transport stream, it asks the TIF to fill in the component data. If the tune request does not already have a components list, the Network Provider calls this method and asks the TIF to create one based on the relevant transport stream tables. Generally, the components will include one or more audio streams, video, data, and text. Each component has a component type, and on MPEG2 tuning spaces each component has an associated PID and pcrPID. Ideally, when the Guide Store Loader creates tune requests, it will include all the component information that is available.

The ITuneRequestInfo::GetComponentData method is used to enable the TIF to change an existing list of components. S_FALSE indicates nothing was changed.

Requirements

Header

Declared in Bdatif.h.

Share via