MF_TRANSCODE_ENCODINGPROFILE attribute

Specifies the device conformance profile for encoding Advanced Streaming Format (ASF) files.

Data type

LPWSTR

Get/set

To get this attribute, call IMFAttributes::GetAllocatedString.

To set this attribute, call IMFAttributes::SetString.

Remarks

Use this attribute when transcoding to a device that supports Windows Media. If this attribute is set, the encoder will use the device conformance profile, or template, for Windows Media codecs. Set the attribute on the transcode profile before building the transcode topology.

The value of this attribute can be any of the conformance template strings listed in the following topics:

For Windows Media Video encoding, the topology builder uses this attribute to set the MFPKEY_DECODERCOMPLEXITYREQUESTED property on the encoder. The encoder will attempt to use the specified template to encode the content. To get the actual template, traverse the nodes of the transcode topology to get a pointer to the encoder node. Then get the value of the MFPKEY_DECODERCOMPLEXITYPROFILE property from the encoder.

The topology builder also uses the value of this attribute to set the "DeviceConformanceTemplate" property on the ASF media sink.

If this attribute is set, the metadata object of the ASF file is always generated irrespective of the application-specified value of the MF_TRANSCODE_SKIP_METADATA_TRANSFER attribute.

Typical values for this attribute include the following:

Value Description
"AP" Advanced profile video
"MP" Main profile video
"SP" Simple profile video
"MP@LL" Main profile, medium level video
"L2" Audio profile, <= 160 Kbps

 

The GUID constant for this attribute is exported from mfuuid.lib.

Requirements

Requirement Value
Minimum supported client
Windows 7 [desktop apps only]
Minimum supported server
Windows Server 2008 R2 [desktop apps only]
Header
Mfidl.h

See also

Alphabetical List of Media Foundation Attributes

Transcode API

IMFTranscodeProfile::GetAudioAttributes

IMFTranscodeProfile::SetAudioAttributes

IMFTranscodeProfile::SetVideoAttributes

IMFTranscodeProfile::GetVideoAttributes