ITuningSpace::CreateTuneRequest

The CreateTuneRequest method creates a COM object representing an empty (uninitialized) tune request.

Syntax

HRESULT CreateTuneRequest(
    ITuneRequest** ppTuneRequest
    );

Parameters

ppTuneRequest

[out] Address of an ITuneRequest interface pointer that receives the new tune request object.

Return Values

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

Remarks

This method returns the ITuneRequest base class interface, but this interface cannot be used to create a tune request. To create a tune request you must use the derived interface that is associated with the type of tuning space you are using. To obtain the derived interface, call QueryInterface on the returned ITuneRequest object and specify the required interface. The following table shows the relationships between tuning spaces and tune requests.

See Also

• ITuningSpace Interface