ITuneRequest::get_Components

 
Microsoft DirectShow 9.0

ITuneRequest::get_Components

The get_Components method retrieves the components contained in this tune request.

Syntax

  HRESULT get_Components(
    IComponents** ppComponents
);

Parameters

ppComponents

[out] Address of a variable that receives an IComponents interface pointer.

Return Values

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

A tune request always contains a collection of components, but the collection can be empty. If the component information is present in the transport stream tables, a Guide Store loader can obtain the information from the TIF and include it in the tune request at the time it creates it.

If the method succeeds, the IComponents interface has an outstanding reference count. The caller must release the interface.

After a tune request is submitted to the Network Provider filter, the Network Provider updates the component lists in the tune request. You can get the updated component list by calling ITuner::get_TuneRequest on the Network Provider, and then calling get_Components on the returned tune request. (The original tune request that was submitted to the Network Provider does not get updated, because the Network Provider creates an internal copy of the tune request. Therefore, you have to call get_TuneRequest to get the updated component list.)

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also