Edit

Share via


CODECAPI_AVEncVideoOutputBitsUsedMapBlockSize property

Specifies the block size used in generating the output metadata bits used map from the encoder.

Data type

ULONG (VT_UI4)

Property GUID

CODECAPI_AVEncVideoOutputBitsUsedMapBlockSize

Property value

The block size. The value must be a power of 2, such as 16 or 32. Setting the block size to 0 disables bits used map block size reporting. Bits used map block size reporting is disabled by default.

Remarks

The block size used in generating the output metadata bits used map from the encoder. With the block size, applications can derive the columns and rows of the output metadata QP map by the video frame width and height divided by the block size. For example, if the block size is 16 and the video frame has the size of 1920x1080, the QP map has 120 columns and 68 rows. If the video frame width/height is not an exact multiple of the block size, round up the width/height to the next multiple of the block size. For example, if the frame size is 1916x1076 and block size is 16, the rounded up frame size is 1920x1088.

Use ICodecAPI::IsSupported to check if the encoder supports this property. Use ICodecAPI::GetValue to query the value of this property. Use ICodecAPI::SetValue to configure this property. Values that are not a power of 2, or 0, result in an E_INVALIDARG return value from SetValue.

Requirements

Requirement Value
Minimum supported client Windows 11, build 26100
Minimum supported server Windows Server 2025
Header Codecapi.h

See also