跳到主要内容

hi_mpi_dvpp_get_image_info

hi_mpi_dvpp_malloc​

函数功能​

申请Device上的内存，申请的内存满足媒体数据处理的要求（例如，内存首地址128字节对齐）。

约束说明​

  • 调用该接口申请内存后，这部分内存的生命周期由用户自行管理，如果不使用，必须调用hi_mpi_dvpp_free接口及时释放内存。

  • 通过该接口申请的内存仅支持在单个进程内使用，不能在多个进程之间共享。

  • 调用hi_mpi_dvpp_malloc接口申请内存时，会对用户输入的size按向上对齐成32整数倍后，再多加32字节。

  • 媒体数据处理的输出作为模型推理的输入时，若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下要求：

    • 内存大小向上对齐成32整数倍+32字节（m=ALIGN_UP[len,32]+32字节）；
    • 内存起始地址需满足128字节对齐（ALIGN_UP[m,128]）。

    :::note 说明 len表示某段内存的大小，ALIGN_UP[len,k]表示向上按k字节对齐：((len-1)/k+1)*k。 :::

函数原型​

hi_s32 hi_mpi_dvpp_malloc(hi_u32 dev_id, hi_void **dev_ptr, hi_u64 size)

参数说明​

参数名输入/输出说明
dev_id输入Device ID，预留参数，该参数配置无效。
dev_ptr输出“Device上已分配内存的指针”的指针。
size输入申请内存的大小，单位Byte。

返回值说明​

  • 0：成功
  • 非0：失败

参考资源​

接口调用流程及示例，参见媒体数据处理V2。

父主题： 公共接口

hi_mpi_dvpp_free​

函数功能​

释放Device上的内存。

hi_mpi_dvpp_free接口只能释放通过hi_mpi_dvpp_malloc接口申请的内存。

函数原型​

hi_s32 hi_mpi_dvpp_free(hi_void *dev_ptr)

参数说明​

参数名输入/输出说明
dev_ptr输入待释放内存的指针。

返回值说明​

  • 0：成功
  • 非0：失败

参考资源​

接口调用流程及示例，参见媒体数据处理V2。

父主题： 公共接口

hi_mpi_dvpp_get_image_info​

函数功能​

根据输入码流，获取按源图格式输出时的图片宽、高、宽stride、高stride、解码后占用的内存大小、源图片格式等信息。该接口会检查图片格式是否支持解码，如果遇到不支持的码流则该接口会返回HI_ERR_VDEC_NOT_SUPPORT错误码，该错误码的详细描述请参见VDEC视频解码/JPEGD图片解码返回码。

函数原型​

hi_s32 hi_mpi_dvpp_get_image_info(hi_payload_type img_type, const hi_vdec_stream *stream, hi_img_info *img_info);

参数说明​

参数名输入/输出说明
img_type输入要解析的码流类型。 当前仅支持码流类型为HI_PT_JPEG。
stream输入输入码流信息的指针。 Atlas 200/500 A2推理产品，RC模式下，在Device上调用本接口时，该结构体内的addr参数配置的地址必须是Device上的内存地址。
img_info输出图片信息的指针，包含图片宽、高、宽stride、高stride、解码后占用的内存大小、源图片格式等信息。 其中，源图格式通过pixel_format参数返回。

返回值说明​

父主题： 公共接口

hi_mpi_dvpp_get_version​

函数功能​

查询接口版本号，版本号命名采用：A.B.C模式，其中，A表示有不兼容修改，B表示新增接口，C表示bug修复。

函数原型​

hi_s32 hi_mpi_dvpp_get_version(hi_s32 *major_version, hi_s32 *minor_version, hi_s32 *patch_version)

参数说明​

参数名输入/输出说明
major_version输出主版本号指针，从1开始，如果出现接口的不兼容变更时，加1。
minor_version输出次版本号指针，从0开始，按照迭代周期，有新增接口时加1。
patch_version输出补丁版本号指针，从0开始，表示本版本仅仅解决了问题，在major_version、minor_version不变的情况下加1；但major_version、minor_version增加的时候，patch_version一般为0。

返回值说明​

父主题： 公共接口

hi_mpi_sys_create_epoll​

函数功能​

创建新的媒体数据处理的Epoll实例，使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_create_epoll(hi_s32 size, hi_s32 *epoll_fd)

参数说明​

参数名输入/输出说明
size输入Epoll实例最大可处理的DVPP通道文件句柄个数，当前该字段为预留，传入一个正数即可。
epoll_fd输出Epoll实例句柄的指针。句柄个数受限于Linux操作系统的open files（一个任务最多可以同时打开的文件个数）资源限制，您可以使用ulimit -al命令查看open files。

返回值说明​

参考资源​

接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

hi_mpi_sys_ctl_epoll​

函数功能​

在媒体数据处理Epoll实例中，对对应的媒体数据处理通道进行控制操作（增、删、改）。

约束说明​

函数原型​

hi_s32 hi_mpi_sys_ctl_epoll(hi_s32 epoll_fd, hi_s32 operation, hi_s32 fd, hi_dvpp_epoll_event *event)

参数说明​

参数名输入/输出说明
epoll_fd输入Epoll实例句柄，句柄需提前通过hi_mpi_sys_create_epoll接口创建。
operation输入操作类型（增、删、改），参见hi_dvpp_epoll_ctl_op。
fd输入媒体数据处理通道的文件句柄。VENC场景下，您可以调用hi_mpi_venc_get_fd接口提前获取该文件句柄。VDEC场景下，您可以调用hi_mpi_vdec_get_fd接口提前获取该文件句柄。
event输入Epoll事件信息的指针。 该参数用于描述对应媒体数据处理通道事件类型以及关联的用户数据。 进行删除操作时，该字段不用，可直接传入NULL。

返回值说明​

参考资源​

接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

在线提单