ITuningSpaceContainer::_TuningSpacesForCLSID 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 _TuningSpacesForCLSID method retrieves a collection of tuning spaces that match the specified CLSID.

Syntax

HRESULT _TuningSpacesForCLSID(
  [in]  REFCLSID      SpaceCLSID,
  [out] ITuningSpaces **NewColl
);

Parameters

[in] SpaceCLSID

Specifies the CLSID of the tuning spaces to retrieve.

[out] NewColl

Address of a variable that receives an ITuningSpaces interface pointer. 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

The CLSID represents the object that implements the tuning space. The same object may implement several related tuning spaces. For example, ATSC Digital Antenna and ATSC Digital Cable are both supported by the ATSCTuningSpace object (CLSID_ATSCTuningSpace).

This method matches against the CLSID returned by the ITuningSpace::get_CLSID method. The returned collection might be empty; call ITuningSpaces::get_Count to determine how many tuning spaces were returned.

Requirements

See also

ITuningSpaceContainer Interface