Share via


IWMVideoForceKeyFrame::SetKeyFrame

banner art

Specifies that the current frame will be encoded as a key frame.

Syntax

HRESULT SetKeyFrame();

Parameters

This method takes no parameters.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Requirements

Client: Requires Windows Vista or Windows XP.

Header: Include wmcodecdsp.h.

Remarks

To force the encoder to make the current frame a key frame, call this method before calling IMediaObject::ProcessOutput or IMFTransform::ProcessOutput.

Each call to this method applies to a single frame. After processing this frame, the encoder resumes automatically assigning key frames (bounded by the maximum key frame distance).

See Also