acl.himpi.dvpp_get_image_info
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功能不支持使用该接口。 |
父主题： 公共接口
在线提单