AVEncCommonFormatConstraint property

Article
07/27/2023

[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 target format for an encoder.

This property is read/write.

Data type

BSTR (VT_BSTR)

Property GUID

CODECAPI_AVEncCommonFormatConstraint

Property value

The value of this property is a BSTR that contains the string representation of a GUID. The following GUIDs are defined.

GUID	Description
CODECAPI_GUID_AVEncCommonFormatATSC	ATSC cable television.
CODECAPI_GUID_AVEncCommonFormatDVB	DVB cable television.
CODECAPI_GUID_AVEncCommonFormatDVD_DashVR	DVD-VR
CODECAPI_GUID_AVEncCommonFormatDVD_PlusVR	DVD+VR
CODECAPI_GUID_AVEncCommonFormatDVD_V	DVD-Video
CODECAPI_GUID_AVEncCommonFormatHighMAT	HighMAT
CODECAPI_GUID_AVEncCommonFormatHighMPV	Not documented in this release.
CODECAPI_GUID_AVEncCommonFormatMP3	MPEG Audio Layer-3 (MP3)
CODECAPI_GUID_AVEncCommonFormatSVCD	Super Video CD (SVCD)
CODECAPI_GUID_AVEncCommonFormatUnSpecified	Unspecified format.
CODECAPI_GUID_AVEncCommonFormatVCD	Video CD (VCD)

Remarks

Applications can set this property to specify the target format. Encoders can also return this property as a capability.

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