IBDACreateTuneRequestEx::CreateTuneRequestEx Method

[This documentation is preliminary and is subject to change.]
Creates a new tuning request for a tuning space. This method enables the caller to specify a particular type of tuning request.

Syntax

HRESULT CreateTuneRequestEx(
  [in]   REFCLSID TuneRequestIID,
  [out]  ITuneRequest **ppTuneRequest
);

Parameters

  • TuneRequestIID [in]
    GUID that identifies the type of ITuneRequest object expected by the caller. If this value is "NULL", this method behaves the same as ITuningSpace::CreateTuneRequest and creates an empty (uninitialized) ITuneRequest object.

  • ppTuneRequest [out]
    Address of a variable that receives a pointer to the ITuneRequest interface of the new tuning request object. The caller must release the interface. If the TuneRequestIID argument is NULL, this address is set to NULL also.

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Client Requires Windows 7.
IDL Declared in Tuner.idl.

See Also

IBDACreateTuneRequestEx
ITuningSpace::CreateTuneRequest

Send comments about this topic to Microsoft

Build date: 12/4/2008