ITuningSpace::get_DefaultPreferredComponentTypes 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_DefaultPreferredComponentTypes method returns a list of the default preferred component types for this tuning space.

Syntax

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

Parameters

[out] ComponentTypes

Address of a variable that receives an IComponentTypes interface pointer. Use this interface to enumerate the component types. The caller must release the interface.

Return value

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

Remarks

A component is a stream within the program. An example of a preferred component type would be an audio stream in English. When multiple components are available, the Tuner attempts to play the preferred ones first.

If the tuning space does not have any default preferred types, this method succeeds but returns the value NULL in the ppComponentTypes parameter. Check for a NULL value before attempting to dereference the pointer.

Requirements

See also

ITuningSpace Interface