| Microsoft DirectX 8.1 (C++) |
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(
ITuneRequest* pCurrentRequest
);
Parameters
pCurrentRequest
[in] Pointer to the ITuneRequest interface on the tune request.
Return Values
The method returns an HRESULT. Possible values include, but are not limited to, 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.
See Also