ITuningSpaceContainer::_TuningSpacesForCLSID

 
Microsoft DirectShow 9.0

ITuningSpaceContainer::_TuningSpacesForCLSID

The _TuningSpacesForCLSID method retrieves a collection of tuning spaces that match the specified CLSID.

Syntax

  HRESULT _TuningSpacesForCLSID(
    REFCLSID SpaceCLSID,
    ITuningSpaces** ppTuningSpaces
);

Parameters

SpaceCLSID

[in] Specifies the CLSID of the tuning spaces to retrieve.

ppTuningSpaces

[out] Address of a variable that receives an ITuningSpaces interface pointer. The caller must release the interface.

Return Values

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

  Header: Dshow.h.

  Library: Quartz.dll.

See Also