hi_mpi_hdmi_set_infoframe

Applicability

Function Description

Sets the information frame.

Prototype

hi_s32 hi_mpi_hdmi_set_infoframe(hi_hdmi_id hdmi, const hi_hdmi_infoframe *infoframe)

Parameters

Returns

• 0: success
• Other values: failure. For details, see HDMI Peripheral Return Codes.

Restrictions

• Before calling this API, you must enable the HDMI by calling hi_mpi_hdmi_open, set the basic attributes by calling hi_mpi_hdmi_set_attr, and set the output color space, aspect ratio, and timing attributes by calling this API. (If the preceding parameters do not need to be specified, use the default values. In this case, you do not need to call this API.) Ensure that the values of hi_hdmi_id in the input parameters of the three interfaces are the same.
• Currently, this API supports only the information frames of HI_INFOFRAME_TYPE_AUDIO and HI_INFOFRAME_TYPE_AVI.
• In the HI_INFOFRAME_TYPE_AVI information frame, only the timing_mode parameter (which must be the same as the timing input by the VO), color_space parameter (which must be set to YUV444 when the user sends pictures), and aspect_ratio parameter (which can only be set to 16:9 or 4:3) of the hi_hdmi_infoframe structure can be changed to non-default values,
• The parameters in the HI_INFOFRAME_TYPE_AUDIO information frame must be set to default values and cannot be modified currently. For details about the value assignment requirements, see the description of the hi_hdmi_audio_infoframe data type.
• Some attributes of this API cannot be set. For details, see the description of hi_hdmi_infoframe.
• After this API is called to set the attributes related to the information frame, they take effect as the attr attribute.
• This is an advanced API. It is not called typically. To use this API, you need to configure the information frame based on the related audio/video attributes such as enVideoFmt and the standards, including High-Definition Multimedia Interface Specification Version 1.4b, High-Definition Multimedia Interface Specification Version 2.0, CEA-861-D, and CEA-861-F. The behavior of transmitting the information frame that does not comply with the audio/video attributes and standards is undefined.
• Currently, this API does not support multiple processes.