hi_mpi_sys_create_epoll
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参数返回。 |
返回值说明
- 0:成功
- 非0:失败,参见VDEC视频解码/JPEGD图片解码返回码。
父主题: 公共接口
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。 |
返回值说明
- 0:成功
- 非0:失败,参见公共返回码
父主题: 公共接口
hi_mpi_sys_create_epoll
函数功能
创建新的媒体数据处理的Epoll实例,使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。
约束说明
- hi_mpi_sys_create_epoll、hi_mpi_sys_ctl_epoll、hi_mpi_sys_wait_epoll、hi_mpi_sys_close_epoll这几个接口要配合使用,实现使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。
- Atlas 200/500 A2推理产品,仅能使用AscendCL提供的Epoll接口(例如,hi_mpi_sys_create_epoll),不能使用Linux操作系统的Epoll函数。
- VPC功能不支持使用该接口。
函数原型
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。 |
返回值说明
- 0:成功
- 非0:失败,参见公共返回码
参考资源
接口调用流程及示例,参见JPEGE图片编码、VENC视频编码。
父主题: 公共接口
hi_mpi_sys_ctl_epoll
函数功能
在媒体数据处理Epoll实例中,对对应的媒体数据处理通道进行控制操作(增、删、改)。
约束说明
- hi_mpi_sys_create_epoll、hi_mpi_sys_ctl_epoll、hi_mpi_sys_wait_epoll、hi_mpi_sys_close_epoll这几个接口要配合使用,实现使用epoll编程模型操作媒体数据处理通道的输入/输出数据。
- VPC功能不支持使用该接口。
函数原型
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。 |
返回值说明
- 0:成功
- 非0:失败,参见公共返回码
参考资源
接口调用流程及示例,参见JPEGE图片编码、VENC视频编码。
父主题: 公共接口
hi_mpi_sys_wait_epoll
函数功能
使用Epoll模型进行媒体数据处理通道输入输出操作,等待媒体数据处理Epoll实例产生事件。
约束说明
- hi_mpi_sys_create_epoll、hi_mpi_sys_ctl_epoll、hi_mpi_sys_wait_epoll、hi_mpi_sys_close_epoll这几个接口要配合使用,实现使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。
- VPC功能不支持使用该接口。
函数原型
hi_s32 hi_mpi_sys_wait_epoll(hi_s32 epoll_fd, hi_dvpp_epoll_event *events, hi_s32 max_events, hi_s32 timeout, hi_s32 *event_num)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| epoll_fd | 输入 | 媒体数据处理Epoll实例句柄的指针。 |
| events | 输出 | hi_dvpp_epoll_event数组,保存产生的事件信息。 |
| max_events | 输入 | 最大可返回的事件数,不应超过events数组的元素个数。 |
| timeout | 输入 | 超时时间,单位是毫秒。 - -1:永久阻塞 - 0:立即返回 - >0:配置具体的超时时间 |
| event_num | 输出 | Epoll实际产生的事件数的指针。 |
返回值说明
- 0:成功
- 非0:失败,参见公共返回码
参考资源
接口调用流程及示例,参见JPEGE图片编码、VENC视频编码。
父主题: 公共接口
hi_mpi_sys_close_epoll
函数功能
使用Epoll模型进行媒体数据处理通道输入输出操作,销毁媒体数据处理Epoll实例。
约束说明
- hi_mpi_sys_create_epoll、hi_mpi_sys_ctl_epoll、hi_mpi_sys_wait_epoll、hi_mpi_sys_close_epoll这几个接口要配合使用,实现使用epoll编程模型操作媒体数据处理通道的输入/输出数据。
- VPC功能不支持使用该接口。
函数原型
hi_s32 hi_mpi_sys_close_epoll(hi_s32 epoll_fd)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| epoll_fd | 输入 | 待销毁媒体数据处理Epoll实例句柄,句柄通过hi_mpi_sys_create_epoll接口创建。 |
返回值说明
- 0:成功
- 非0:失败,参见公共返回码
参考资源
接口调用流程及示例,参见JPEGE图片编码、VENC视频编码。
父主题: 公共接口
在线提单