IAMDroppedFrames Interface
| Microsoft DirectShow 9.0 |
IAMDroppedFrames Interface
The IAMDroppedFrames interface retrieves performance information from a video capture filter, including how many frames were dropped and how many were delivered. Applications can use this interface to determine capture performance at run-time.
In addition to the methods inherited from IUnknown, the IAMDroppedFrames interface exposes the following methods.
| Method | Description |
| GetAverageFrameSize | Retrieves the average size of the frames that the filter has captured. |
| GetDroppedInfo | Retrieves an array of frame numbers that were dropped. |
| GetNumDropped | Retrieves the total number of frames that the filter has dropped since it started streaming. |
| GetNumNotDropped | Retrieves the total number of frames that the filter has delivered since it started streaming. |
Remarks
Some filters that expose this interface do not implement the GetDroppedInfo or GetAverageFrameSize method.
For Windows Driver Model (WDM) devices, the WDM Video Capture Filter automatically exposes this interface if the WDM driver supports the PROPSETID_VIDCAP_DROPPEDFRAMES property set. For more information, see the Windows DDK documenation.
The number of dropped frames is reported by the capture driver. This information is not directly correlated with any particular media sample, so it is not accurate on a per-frame basis, although it should be accurate over time.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.