跳到主要内容

acl.himpi.dvpp_get_version

acl.himpi.dvpp_malloc​

c函数原型hi_s32 hi_mpi_dvpp_malloc(hi_u32 dev_id, hi_void **dev_ptr, hi_u64 size)
Python函数dev_ptr, ret = acl.himpi.dvpp_malloc(dev_id, size)
函数功能申请Device上的内存，申请的内存满足媒体数据处理的要求（例如，内存首地址128字节对齐）。
输入说明- dev_id：Device ID，预留参数，该参数配置无效。
- size：申请内存的大小，单位Byte。
返回值说明ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见公共返回码。
devPtr：int，指向Device上已分配内存的指针地址。
约束说明- 调用该接口申请内存后，这部分内存的生命周期由用户自行管理，如果不使用，必须调用acl.himpi.dvpp_free接口及时释放内存。
- 通过该接口申请的内存仅支持在单个进程内使用，不能在多个进程之间共享。
- 调用acl.himpi.dvpp_malloc接口申请内存时，会对用户输入的size按向上对齐成32整数倍后，再多加32字节。
- 媒体数据处理的输出作为模型推理的输入时，若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下要求：
- 内存大小向上对齐成32整数倍+32字节（m=ALIGN_UP[len,32]+32字节）；
- 内存起始地址需满足128字节对齐（ALIGN_UP[m,128]）。（说明：len表示某段内存的大小，ALIGN_UP[len,k]表示向上按k字节对齐：((len-1)/k+1)*k。）
参考资源接口调用流程示例，参见媒体数据处理V2。

父主题： 公共接口

acl.himpi.dvpp_free​

c函数原型hi_s32 hi_mpi_dvpp_free(hi_void *dev_ptr)
Python函数ret = acl.himpi.dvpp_free(dev_ptr)
函数功能释放Device上的内存。 acl.himpi.dvpp_free接口只能释放通过acl.himpi.dvpp_malloc接口申请的内存。
输入说明dev_ptr：int，待释放内存的指针地址。
返回值说明ret：int 错误码。
- 返回0表示成功。
- 返回非0表示失败。参见公共返回码
参考资源接口调用流程示例，参见媒体数据处理V2。

父主题： 公共接口

acl.himpi.dvpp_get_image_info​

c函数原型hi_s32 hi_mpi_dvpp_get_image_info(hi_payload_type img_type, const hi_vdec_stream *stream, hi_img_info *img_info);
Python函数img_info, ret = acl.himpi.dvpp_get_image_info(img_type, stream)
函数功能根据输入码流，获取按源图格式输出时的图片宽、高、宽Stride、高Stride、解码后占用的内存大小、源图片格式等信息。 该接口会检查图片格式是否支持解码，如果遇到不支持的码流则该接口会返回HI_ERR_VDEC_NOT_SUPPORT错误码，该错误码的详细描述请参见公共返回码。
输入说明- img_type：要解析的码流类型。当前仅支持码流类型为HI_PT_JPEG。
- stream：输入码流信息。
返回值说明img_info：图片信息字典。 ret：int，错误码。
- 返回0，表示成功。
- 返回非0，表示失败。参见公共返回码。

父主题： 公共接口

acl.himpi.dvpp_get_version​

c函数原型hi_s32 hi_mpi_dvpp_get_version(hi_s32 *major_version, hi_s32 *minor_version, hi_s32 *patch_version)
Python函数major_version, minor_version, patch_version, ret = acl.himpi.dvpp_get_version()
函数功能查询接口版本号，版本号命名采用：A.B.C模式，其中，A表示有不兼容修改，B表示新增接口，C表示bug修复。
返回值说明- major_version：主版本号，从1开始，如果出现接口的不兼容变更时，加1。
- minor_version：次版本号，从0开始，按照迭代周期，有新增接口时加1。
- patch_version：补丁版本号，从0开始，表示本版本仅仅解决了问题，在major_version、minor_version不变的情况下加1；但major_version、minor_version增加的时候，patch_version一般为0。
**ret：**int，错误码。
- 返回0表示成功。
- 返回非0表示失败。参见公共返回码。

父主题： 公共接口

acl.himpi.sys_create_epoll​

c函数原型hi_s32 hi_mpi_sys_create_epoll(hi_s32 size, hi_s32 *epoll_fd);
Python函数epoll_fd, ret = acl.himpi.sys_create_epoll(size)
函数功能创建新的媒体数据处理的Epoll实例，使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。
输入说明size：Epoll实例最大可处理的DVPP通道文件句柄个数，当前该字段为预留，传入一个正数即可。
返回值说明epoll_fd：Epoll实例句柄的指针地址。句柄个数受限于Linux操作系统的open files（一个任务最多可以同时打开的文件个数）资源限制，您可以使用ulimit -al命令查看open files。 ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见公共返回码。
约束说明- acl.himpi.sys_create_epoll、acl.himpi.sys_ctl_epoll、acl.himpi.sys_wait_epoll、acl.himpi.sys_close_epoll这几个接口要配合使用。使用epoll编程模型操作DVPP通道的输入/输出数据。
- VPC功能不支持使用该接口。

父主题： 公共接口

acl.himpi.sys_ctl_epoll​

c函数原型hi_s32 hi_mpi_sys_ctl_epoll(hi_s32 epoll_fd, hi_s32 operation, hi_s32 fd, hi_dvpp_epoll_event *event);
Python函数ret = acl.himpi.sys_ctl_epoll(epoll_fd, operation, fd, event)
函数功能在媒体数据处理Epoll实例中，对对应的媒体数据处理通道进行控制操作（增、删、改）。
输入说明- epoll_fd：Epoll实例句柄，句柄需提前通过acl.himpi.sys_create_epoll接口创建。
- operation：操作类型（增、删、改），参见acl.hi.dvpp_epoll_ctl_op。
- fd：媒体数据处理通道的文件句柄。VENC场景下，您可以调用acl.himpi.venc_get_fd接口提前获取该文件句柄。VDEC场景下，您可以调用acl.himpi.vdec_get_fd接口提前获取该文件句柄。
- event：Epoll事件信息的指针地址。该参数用于描述对应媒体数据处理通道事件类型以及关联的用户数据。 进行删除操作时，该字段无效。
返回值说明ret：int，错误码。
- 返回0，表示成功。
- 返回非0，表示失败，参见公共返回码。
约束说明- acl.himpi.sys_create_epoll、acl.himpi.sys_ctl_epoll、acl.himpi.sys_wait_epoll、acl.himpi.sys_close_epoll这几个接口要配合使用，实现使用epoll编程模型操作媒体数据处理通道的输入/输出数据。
- VPC功能不支持使用该接口。
参考资源接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

acl.himpi.sys_wait_epoll​

c函数原型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);
Python函数event, event_num, ret = acl.himpi.sys_wait_epoll(epoll_fd, max_events, timeout)
函数功能使用Epoll模型进行媒体数据处理通道输入输出操作，等待媒体数据处理Epoll实例产生事件。
输入说明- epoll_fd：媒体数据处理Epoll实例句柄的指针地址。
- max_events：最大可返回的事件数，不应超过events数组的元素个数。
- timeout：超时时间，单位是毫秒。
- -1：永久阻塞。
- 0：立即返回。
- >0：配置具体的超时时间。
返回值说明event：hi_dvpp_epoll_event数组，保存产生的事件信息。 event_num：Epoll实际产生的事件数。 ret：int，错误码。
- 返回0表示成功。
- 返回非0表示失败，参见公共返回码。
约束说明- acl.himpi.sys_create_epoll、acl.himpi.sys_ctl_epoll、acl.himpi.sys_wait_epoll、acl.himpi.sys_close_epoll这几个接口要配合使用，实现使用Epoll编程模型操作媒体数据处理通道的输入/输出数据。
- VPC功能不支持使用该接口。
参考资源接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

父主题： 公共接口

在线提单