IAMVideoControl 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.]
The IAMVideoControl interface controls certain video capture operations such as enumerating available frame rates and image orientation.
Inheritance
The IAMVideoControl interface inherits from the IUnknown interface. IAMVideoControl also has these types of members:
Methods
The IAMVideoControl interface has these methods.
| IAMVideoControl::GetCaps The GetCaps method retrieves the capabilities of the underlying hardware. |
| IAMVideoControl::GetCurrentActualFrameRate The GetCurrentActualFrameRate method retrieves the actual frame rate, expressed as a frame duration in 100-nanosecond units. |
| IAMVideoControl::GetFrameRateList The GetFrameRateList method retrieves a list of available frame rates. |
| IAMVideoControl::GetMaxAvailableFrameRate The GetMaxAvailableFrameRate method retrieves the maximum frame rate currently available, based on bus bandwidth usage for connections, such as USB and IEEE 1394, where the maximum frame rate may be limited by bandwidth availability. |
| IAMVideoControl::GetMode The GetMode method retrieves the video control mode of operation. |
| IAMVideoControl::SetMode The SetMode method sets the video control mode of operation. |
Remarks
For Windows Driver Model (WDM) devices, the WDM Video Capture Filter automatically exposes this interface if the WDM driver supports the PROPSETID_VIDCAP_VIDEOCONTROL property set. For more information, see the Windows Driver Kit (WDK) documentation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |