Microsoft DirectX 8.1 (C++)

IMSVidCtl::get_FeaturesActive

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_FeaturesActive method retrieves the features that are currently active.

Syntax

HRESULT get_FeaturesActive(
  IMSVidFeatures**  ppVal
);

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 */
}

See Also