IMSVidCtl::get_FeaturesActive Method

Article
01/07/2009

This topic applies to Windows XP or later.
The get_FeaturesActive method retrieves the features that are currently active.

Syntax

HRESULT get_FeaturesActive(
  [out]  IMSVidFeatures **ppVal
);

Parameters

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

Return Value

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.

Examples

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

Requirements

Header	Declared in Dshow.h.
DLL	Requires Quartz.dll.

Share via