Microsoft DirectX 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.

See Also