ITuner::get_PreferredComponentTypes 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_PreferredComponentTypes method gets the collection of ComponentType objects used for default component selection.

Syntax

HRESULT get_PreferredComponentTypes(
  [out] IComponentTypes **ComponentTypes
);

Parameters

[out] ComponentTypes

Address of an IComponentTypes interface pointer that receives the collection of ComponentType objects.

Return value

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

Remarks

When a program ends, there may be a new set of stream components available, so at that time the tuner will automatically examine the list of preferred component types and select a component based on that list. If no list is available, the tuner will make a selection based on other factors. Applications call this method simply to examine the current list.

Requirements

See also

Error and Success Codes

ITuner Interface