Microsoft DirectX 8.1 (C++)

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, then the 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 information is not present, an application

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

See Also