hi_mpi_hdmi_set_infoframe

产品支持情况

功能说明

设置信息帧。

函数原型

hi_s32 hi_mpi_hdmi_set_infoframe(hi_hdmi_id hdmi, const hi_hdmi_infoframe *infoframe)

参数说明

返回值说明

• 0：成功
• 非0：失败，参见HDMI外设返回码

约束说明

• 调用本接口前，必须先打开HDMI（调用hi_mpi_hdmi_open），再调用hi_mpi_hdmi_set_attr接口设置基本属性，最后调用本接口补充设置输出颜色空间、宽高比、时序属性（若无需指定上述参数，使用默认值，可不调用本接口），且保持三个接口入参中的hi_hdmi_id值一致。
• 本接口目前只支持HI_INFOFRAME_TYPE_AUDIO和HI_INFOFRAME_TYPE_AVI信息帧。
• HI_INFOFRAME_TYPE_AVI信息帧中只支持修改hi_hdmi_infoframe结构体的timing_mode参数（必须与VO输入的具体时序保持一致）、color_space参数（用户送图时需要设置为YUV444）、aspect_ratio参数（仅支持设置为16比9、4比3）为非默认值，
• HI_INFOFRAME_TYPE_AUDIO信息帧中均需要设置为默认参数，暂不支持修改，详细赋值要求请见hi_hdmi_audio_infoframe数据类型描述。
• 本接口的部分属性不支持设置，详情请见hi_hdmi_infoframe结构体及其成员说明。
• 调用该接口设置信息帧相关属性后，会生效成attr属性。
• 本接口属于高级接口，一般不需要调用。若用户使用，则应根据已设置的音视频相关属性（如enVideoFmt），及遵从《High-Definition Multimedia Interface Specification Version 1.4b》、《High-Definition Multimedia Interface SpecificationVersion 2.0》、《CEA-861-D 》与《CEA-861-F》标准基础上设置信息帧，不依据音视频属性遵从标准发送信息帧的行为是未定义的，暂不支持。
• 本接口暂时不支持多进程场景。