Share via


IMSVidCtl::get_FeaturesActive Method

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.

See Also

IMSVidCtl Interface
IMSVidCtl::put_FeaturesActive
Displaying Closed Captioning in C++

Send comments about this topic to Microsoft

Build date: 12/4/2008