IMSVidCtl::put_FeaturesActive method (msvidctl.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
The put_FeaturesActive method specifies a collection of features to activate.
Syntax
HRESULT put_FeaturesActive(
[in] IMSVidFeatures *pVal
);
Parameters
[in] pVal
Pointer to the IMSVidFeatures interface on a collection of features.
Return value
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
Features represent additional capabilities beyond basic tuning and rendering, such as closed captioning or IP data services. When the Video Control builds the filter graph, it uses the active features collection to configure the graph.
For a default graph, it is not necessary to specify the active features. To activate a feature, create a new MSVidFeatures collection object. Then use the IMSVidCtl::get_FeaturesAvailable method to enumerate the available features, and call IMSVidDevice::get__ClassID on each feature. If the CLSID matches the feature you wish to activate, add that feature to your MSVidFeatures collection. Then call put_FeaturesActive with a pointer to the MSVidFeatures collection.
If the Video Control's state is not STATE_UNBUILT, call the IMSVidCtl::Decompose to tear down the filter graph before calling this method.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | msvidctl.h |