ITuner::get_TuneRequest 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.]

The get_TuneRequest method gets the tune request currently in effect for the Network Provider.

Syntax

HRESULT get_TuneRequest(
  [out] ITuneRequest **TuneRequest
);

Parameters

[out] TuneRequest

Address of an ITuneRequest interface pointer that will be set to the returned object.

Return value

When the method is successful, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

After a tune request is submitted to the Tuner, its Components collection will be filled in. By calling get_TuneRequest after tuning to the program, an application can determine which components are currently available for that program, and then use the IComponent::put_Status method on the Component objects in the collection to activate or inactivate them. This is how an application, for example, changes from an English audio stream to a Spanish audio stream.

Requirements

See also

Error and Success Codes

ITuner Interface