IAMPluginControl interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Controls the preferred and blocked filter lists.
To get a pointer to this interface, call CoCreateInstance. The class identifier (CLSID) is CLSID_DirectShowPluginControl, which is defined in the header file uuids.h.
Inheritance
The IAMPluginControl interface inherits from the IUnknown interface. IAMPluginControl also has these types of members:
Methods
The IAMPluginControl interface has these methods.
| IAMPluginControl::GetDisabledByIndex IAMPluginControl::GetDisabledByIndex (strmif.h) gets a class identifier (CLSID) from the blocked list. |
| IAMPluginControl::GetPreferredClsid Searches the preferred list for a class identifier (CLSID) that matches a specified subtype. |
| IAMPluginControl::GetPreferredClsidByIndex IAMPluginControl::GetPreferredClsidByIndex (strmif.h) gets a class identifier (CLSID) from the preferred list, specified by index value. |
| IAMPluginControl::IsDisabled Queries whether a class identifier (CLSID) appears in the blocked list. (IAMPluginControl.IsDisabled) |
| IAMPluginControl::IsLegacyDisabled Queries whether an Audio Compression Manager (ACM) or Video Compression Manager (VCM) codec appears in the blocked list. |
| IAMPluginControl::SetDisabled Adds a class identifier (CLSID) to the blocked list, or removes a CLSID from the list. (IAMPluginControl.SetDisabled) |
| IAMPluginControl::SetPreferredClsid Adds a class identifier (CLSID) to the preferred list or removes a CLSID from the list. (IAMPluginControl.SetPreferredClsid) |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7 [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |