Function: vdec_destroy_channel

Applicability

Product

Supported

Atlas 350 Accelerator Card

x

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas training product

Atlas inference product

Atlas 200I/500 A2 inference product

Description

Destroys a video processing channel created by the acl.media.vdec_create_channel call.

Prototype

  • C Prototype
    1
    aclError aclvdecDestroyChannel(aclvdecChannelDesc *channelDesc)
    
  • Python Function
    1
    ret = acl.media.vdec_destroy_channel(vdec_channel_desc)
    

Parameters

Parameter

Description

vdec_channel_desc

Int, pointer address of the channel description.

It must be the same as the vdec_channel_desc argument passed to the acl.media.vdec_create_channel call.

Return Value

Return Value

Description

ret

Int, error code. 0 on success; else, failure.

Restrictions

  • The channel is destroyed after the transmitted frames are decoded and the callback function is handled.
  • acl.media.vdec_destroy_channel encapsulates the acl.rt.unsubscribe_report API to cancel thread registration (the callback function on the stream is no longer processed by the specified thread) and the acl.rt.destroy_stream API to destroy the stream. When implementing the VDEC function, you do not need to call the acl.rt.unsubscribe_report and acl.rt.destroy_stream APIs separately.
  • If acl.media.vdec_destroy_channel_desc has been called to destroy the channel description before the acl.media.vdec_destroy_channel call, an error is reported.

Reference

For details about the API call sequence and examples, see Media Data Processing V1.