文档

hi_mpi_hdmi_set_infoframe

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

Description

Sets the information frame.

Restrictions

  • Before calling this API, enable the HDMI by calling hi_mpi_hdmi_open, set 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, without calling this API. In addition, ensure that the values of hi_hdmi_id of the three APIs are the same.
  • Currently, this API supports only the information frames of HI_INFOFRAME_TYPE_AUDIO and HI_INFOFRAME_TYPE_AVI.
  • For the information frame of HI_INFOFRAME_TYPE_AVI, only timing_mode, color_space, and aspect_ratio of the hi_hdmi_infoframe structure can be modified to non-default values. Keep timing_mode the same as the specific timing of the VO input, set color_space to YUV444 when images are sent, and set aspect_ratio to 16:9 or 4:3.
  • For the information frame of HI_INFOFRAME_TYPE_AUDIO, all parameters need to be set to default values and cannot be modified. For details, see hi_hdmi_audio_infoframe.
  • Some attributes of this API cannot be set. For details, see 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.

Prototype

hi_s32 hi_mpi_hdmi_set_infoframe(hi_hdmi_id hdmi, const hi_hdmi_infoframe *infoframe)

Parameters

Parameter

Input/Output

Description

hdmi

Input

HDMI ID.

Value range: [0, 2)

infoframe

Input

Pointer to the structure of the HDMI information frame.

Returns

Parent topic: HDMI Peripherals