Skip to main content

acldvppMalloc

acldvppMalloc​

函数功能​

该接口主要用于分配内存给Device侧媒体数据处理时使用，申请的大页内存满足数据处理的要求（例如，内存首地址128字节对齐），同步接口。

约束说明​

  • 调用该接口申请内存后，如果内存不使用，需及时调用acldvppFree接口释放内存。

  • 频繁调用acldvppMalloc接口申请内存、调用acldvppFree接口释放内存，会损耗性能，建议用户提前做内存预先分配或二次管理，避免频繁申请/释放内存。

  • 调用acldvppMalloc接口申请内存时，会对用户输入的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。 :::

  • 调用该接口申请大页内存失败，仅表示系统内的大页内存不够。

函数原型​

aclError acldvppMalloc(void **devPtr, size_t size)

参数说明​

参数名输入/输出说明
devPtr输出“Device上已分配内存的指针”的指针。
size输入申请内存的大小，单位Byte。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

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

父主题： 内存申请与释放

acldvppFree​

函数功能​

释放通过acldvppMalloc接口申请的内存，同步接口。

函数原型​

aclError acldvppFree(void *devPtr)

参数说明​

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

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

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

父主题： 内存申请与释放

acldvppCreateChannel​

函数功能​

创建图片数据处理的通道，同一个通道可以重复使用，销毁后不再可用，同步接口。

约束说明​

  • 通道为非线程安全，即不同线程要求创建不同的通道。

  • 同一个通道不能同时在多个Stream中并发使用。

  • acldvppCreateChannel接口内部调用1次aclrtCreateStream接口创建了1个Stream，该Stream用于创建通道的任务，创建通道的任务结束后，该Stream资源自动释放。

    用户在创建通道时，aclrtCreateStream接口的约束需要遵循，例如Stream的数量等。

函数原型​

aclError acldvppCreateChannel(acldvppChannelDesc *channelDesc)

参数说明​

参数名输入/输出说明
channelDesc输入&输出通道描述信息的指针。 需提前调用acldvppCreateChannelDesc接口创建acldvppChannelDesc类型的数据。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

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

父主题： VPC/JPEGD/JPEGE/PNGD图片处理通道

acldvppDestroyChannel​

函数功能​

销毁图片数据处理的通道，只能销毁通过acldvppCreateChannel接口创建的通道，同步接口。

约束说明​

如果在调用acldvppDestroyChannel接口销毁通道前，已调用acldvppDestroyChannelDesc接口销毁了通道描述信息，那么在调用acldvppDestroyChannel接口销毁通道时会报错。

函数原型​

aclError acldvppDestroyChannel(acldvppChannelDesc *channelDesc)

参数说明​

参数名输入/输出说明
channelDesc输入通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

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

父主题： VPC/JPEGD/JPEGE/PNGD图片处理通道

aclvdecCreateChannel​

函数功能​

创建视频解码处理的通道，同一个通道可以重复使用，销毁后不再可用，同步接口。

约束说明​

函数原型​

aclError aclvdecCreateChannel(aclvdecChannelDesc *channelDesc)

参数说明​

参数名输入/输出说明
channelDesc输入&输出通道描述信息的指针。 需提前调用aclvdecCreateChannelDesc接口创建aclvdecChannelDesc类型的数据，再调用aclvdecSetChannelDesc系列接口设置通道描述信息的属性。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

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

父主题： VDEC视频解码通道

在线提单