hi_mpi_rgn_attach_to_chn

Product	Supported
Atlas A3 training products / Atlas A3 inference products	x
Atlas A2 training products / Atlas A2 inference products	x
Atlas 200I/500 A2 inference products	√
Atlas inference products	x
Atlas training products	x

Overlays a region on a channel.

The Ascend EP form of Atlas 200I/500 A2 inference products does not support this API.

hi_s32 hi_mpi_rgn_attach_to_chn(hi_rgn_handle handle, const hi_mpp_chn *chn, const hi_rgn_chn_attr *chn_attr)

Parameter	Input/Output	Description
handle	Input	Region handle ID. Value range: [0, 1024)
chn	Input	Pointer to the channel structure. This parameter cannot be empty. For details about how to set this parameter, see Table 2.
chn_attr	Input	Pointer to the channel display attributes of a region. This parameter cannot be null.

Parameter

Input/Output

Description

handle

Input

Region handle ID.

Value range: [0, 1024)

chn

Input

Pointer to the channel structure. This parameter cannot be empty.

For details about how to set this parameter, see Table 2.

chn_attr

Input

Pointer to the channel display attributes of a region. This parameter cannot be null.

The regions must be created before you call this API.
This API can be called for multiple times. However, this API cannot be used to change the attributes of the region created by calling hi_mpi_rgn_create.
If a region is repeatedly overlaid on a specified channel, a code indicating success is returned after this API is called, but the previously configured channel display attributes of the region are not changed.
A maximum of four MOSAIC regions can be bound to the same channel.
A maximum of eight COVER regions can be bound to the same channel.
A maximum of eight OVERLAYEX regions can be bound to the same channel.