函数：dvpp_malloc
函数：dvpp_malloc
| C函数原型 | aclError acldvppMalloc(void **devPtr, size_t size) |
|---|---|
| Python函数 | dev_ptr, ret = acl.media.dvpp_malloc(size) |
| 函数功能 | 该接口主要用于分配内存给Device侧媒体数据处理时使用，申请的大页内存满足数据处理的要求（例如，内存首地址128对齐），同步接口。 |
| 输入说明 | size：int，申请内存的大小，单位Byte。 |
| 返回值说明 | dev_ptr：int，Device上已分配内存的指针地址。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | - 调用该接口申请内存后，如果内存不使用，需及时调用acl.media.dvpp_free接口释放内存。 - 频繁调用acl.media.dvpp_malloc接口申请内存、调用acl.media.dvpp_free接口释放内存，会损耗性能，建议用户提前做内存预先分配或二次管理，避免频繁申请/释放内存。 - 调用acl.media.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。） - 调用该接口申请大页内存失败，仅表示系统内的大页内存不够。 |
| 参考资源 | 接口调用流程及示例，参见媒体数据处理V1。 |
父主题： 内存申请与释放
函数：dvpp_free
| C函数原型 | aclError acldvppFree(void *devPtr) |
|---|---|
| Python函数 | ret = acl.media.dvpp_free(dev_ptr) |
| 函数功能 | 释放通过acl.media.dvpp_malloc接口申请的内存，同步接口。 |
| 输入说明 | dev_ptr：int，待释放内存的指针地址。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
| 参考资源 | 接口调用流程及示例，参见媒体数据处理V1。 |
父主题： 内存申请与释放
函数：dvpp_create_channel
| C函数原型 | aclError acldvppCreateChannel(acldvppChannelDesc *channelDesc) |
|---|---|
| Python函数 | ret = acl.media.dvpp_create_channel(dvpp_channel_desc) |
| 函数功能 | 创建图片数据处理的通道，同一个通道可以重复使用，销毁后不再可用，同步接口。 |
| 输入说明 | dvpp_channel_desc：int，指定通道描述信息。调用acl.media.dvpp_create_channel_desc接口创建该输入数据。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | - 通道为非线程安全，即不同线程要求创建不同的通道。 - 同一个通道不能同时在多个Stream中并发使用。 - acl.media.dvpp_create_channel接口内部调用1次acl.rt.create_stream接口创建了1个Stream，该Stream用于创建通道的任务，创建通道的任务结束后，该Stream资源自动释放。 用户在创建通道时，acl.rt.create_stream接口的约束需要遵循，例如Stream的数量等。 |
| 参考资源 | 接口调用流程与示例，参见媒体数据处理V1。 |
父主题： VPC/JPEGD/JPEGE/PNGD图片处理通道
函数：dvpp_destroy_channel
| C函数原型 | aclError acldvppDestroyChannel(acldvppChannelDesc *channelDesc) |
|---|---|
| Python函数 | ret = acl.media.dvpp_destroy_channel(dvpp_channel_desc) |
| 函数功能 | 销毁图片数据处理的通道，只能销毁通过acl.media.dvpp_create_channel接口创建的通道，同步接口。 |
| 输入说明 | dvpp_channel_desc：int，指定通道描述信息。与调用acl.media.dvpp_create_channel接口创建通道时指定的dvpp_channel_desc保持一致。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 如果在调用acl.media.dvpp_destroy_channel接口销毁通道前，已调用acl.media.dvpp_destroy_channel_desc接口销毁了通道描述信息，那么在调用acl.media.dvpp_destroy_channel接口销毁通道时会报错。 |
| 参考资源 | 接口调用流程及示例，参见媒体数据处理V1。 |
父主题： VPC/JPEGD/JPEGE/PNGD图片处理通道
函数：vdec_create_channel
| C函数原型 | aclError aclvdecCreateChannel(aclvdecChannelDesc *channelDesc) |
|---|---|
| Python函数 | ret = acl.media.vdec_create_channel(vdec_channel_desc) |
| 函数功能 | 创建视频数据处理的通道，同一个通道可以重复使用，销毁后不再可用，同步接口。 |
| 输入说明 | vdec_channel_desc：int，vdec通道描述地址对象, 指定通道描述信息。 调用acl.media.vdec_create_channel_desc接口创建vdec_channel_desc类型的数据，调用acl.media.vdec_set_channel_desc系列接口设置通道描述信息的属性。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | - 通道为非线程安全，即不同线程要求创建不同的通道。 - 通道数的限制，请参见总体说明。 - acl.media.vdec_create_channel接口内部封装了acl.rt.create_stream接口和acl.rt.subscribe_report： - 调用2次acl.rt.create_stream接口创建了2个Stream，一个Stream用于视频码流解码任务，另一个用于回调函数的处理。这些Stream资源只有在调用acl.media.vdec_destroy_channel接口销毁通道后才能自动释放。 - 调用acl.rt.subscribe_report接口指定处理Stream上回调函数的线程，回调函数和线程是由用户调用acl.media.vdec_set_channel_desc系列接口时指定的。 用户在实现VDEC功能时，无需再单独调用acl.rt.create_stream接口、acl.rt.subscribe_report接口，但acl.rt.create_stream接口、acl.rt.subscribe_report接口的约束需要遵循，例如Stream的数量、处理Stream上回调函数的线程数量等。 |
| 参考资源 | 接口调用流程及示例，参见媒体数据处理V1。 |
父主题： VDEC视频解码通道
在线提单