AVEncVideoEncodeDimension property

[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.]

Specifies the width and height of the encoded video, if the video is cropped.

This property is read/write.

Data type

UINT32 (VT_UI4)

Property GUID

CODECAPI_AVEncVideoEncodeDimension

Property value

The upper 16 bits of the value contain the width in pixels, and the lower 16 bits contain the height in pixels.

Remarks

Applications can set this property to crop the input video. The specified size must be less than the size of the input video frames. Use the AVEncVideoEncodeOffsetOrigin property to specify the left and top corners of the clipping rectangle.

Encoders can return this property as a capability.

This property is also used with H.264 UVC 1.5 camera encoders.

For UVC 1.5 camera encoders, AVEncVideoEncodeOffsetOrigin is not supported.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server
Windows 2000 Server [desktop apps | UWP apps]
Header
Codecapi.h

See also

Codec API Properties

ICodecAPI Interface