Partager via

IMSVidCtl::get_FeaturesActive

  • Article
 
Microsoft DirectShow 9.0

IMSVidCtl::get_FeaturesActive

This topic applies to Windows XP or later.

The get_FeaturesActive method retrieves the features that are currently active.

Syntax

  HRESULT get_FeaturesActive(
  
  IMSVidFeatures**
  
  pVal
  
  );

Parameters

  ppVal

[out]  Address of a variable that receives an IMSVidFeatures interface pointer.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

If no features are active, the method might return NULL in the pVal parameter. Otherwise, it returns a collection of feature objects. Use the returned IMSVidFeatures pointer to enumerate the collection.

The returned IMSVidFeatures interface has an outstanding reference count. The caller must release the interface.

Example Code

CComPtr<IMSVidFeatures> pFeatures;
hr = m_pVideoControl->get_FeaturesActive(&pFeatures);
if (SUCCEEDED(hr) && pFeatures)
{
    long c;
    pFs->get_Count(&c);
    /* Enumerate the features */
}

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also