CODECAPI_FeatureMapFlagsUsed property

Provides the encoder a hint as to what feature map capabilities will be used during the encode sequence.

Data type

UINT32

Property GUID

CODECAPI_FeatureMapFlagsUsed

Property value

A bitwise OR combination of any of the flag values that are valid to set on the flags field in the MACROBLOCK_DATA structure.

Remarks

CODECAPI_FeatureMapFlagsUsed is a UINT32 property that can be set on an encoder MFT using the ICodecAPI::SetValue method to provide the encoder a hint as to what feature map capabilities will be used during the encode sequence. In this context, “sequence” means all frames processed between MFT_MESSAGE_NOTIFY_BEGIN_STREAMING and MF_MESSAGE_NOTIFY_END_STREAMING. This enables encoders that support the property to make stream level optimizations based on the specified set of unused capabilities, if any.

The encoder MFT should assume that any flag specified this way may be used in the feature map passed to the encoder, and alternately, any flag not present will never appear in the feature map. If CODECAPI_FeatureMapFlagsUsed is not set, then the encoder will use the default value, 0xFFFFFFFF, and assume that all feature map flags may be used.

ICodecAPI::GetParameterValues can be used with CODECAPI_FeatureMapFlagsUsed to query which feature map flags are supported by an encoder. Any values present in the returned UINT32-type VARIANT are values for the flags field in the MACROBLOCK_DATA structure that the encoder is capable of processing.

ICodecAPI::IsSupported can be used with CODECAPI_FeatureMapFlagsUsed to determine if the encoder recognizes the new property.

Requirements

Requirement	Value
Minimum supported client	Windows 10 [desktop apps only]
Minimum supported server	Windows Server 2016 [desktop apps only]
Header	Codecapi.h

See also

Media Foundation Properties