Share via


IBDACreateTuneRequestEx::CreateTuneRequestEx method (tuner.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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 **TuneRequest
);

Parameters

[in] TuneRequestIID

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.

[out] TuneRequest

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 this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows�7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header tuner.h

See also

IBDACreateTuneRequestEx

ITuningSpace::CreateTuneRequest