hi_mpi_rgn_attach_to_chn
The
The
Description
Overlays a region on a channel.
Restrictions
- 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.
Prototype
hi_s32 hi_mpi_rgn_attach_to_chn(hi_rgn_handle handle, const hi_mpp_chn *chn, const hi_rgn_chn_attr *chn_attr)
Parameters
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. |
Returns
- 0: success.
- Other values: failure. For details, see Region Management Return Codes.
Parent topic: Region Management