IAMVideoCompression::OverrideKeyFrame
| Microsoft DirectShow 9.0 |
IAMVideoCompression::OverrideKeyFrame
The OverrideKeyFrame method instructs the filter to compress a particular frame as a key frame.
Syntax
HRESULT OverrideKeyFrame( long FrameNumber );
Parameters
FrameNumber
[in] Specifies the frame number. The first frame that the filter delivers is numbered zero.
Return Values
Returns an HRESULT value. Possible values include the following.
| Return code | Description |
| S_OK | Success. |
| E_NOTIMPL | Not implemented. |
Remarks
If the filter supports this method, you can use it to override the normal key-frame distribution for a particular frame. After the filter creates a key frame, it might reset its count to determine when the next key frame should occur. For example, if the key-frame rate is 10, and an application uses this method to force frame 5 as a key frame, the filter might wait another 10 frames (until frame 15) before it creates the next key frame.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also