Function: vdec_set_channel_desc_thread_id

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

Sets the decoding channel description attribute: callback thread ID.

Prototype

C Prototype

aclError aclvdecSetChannelDescThreadId(aclvdecChannelDesc *channelDesc, uint64_t threadId)

Python Function

ret = acl.media.vdec_set_channel_desc_thread_id(vdec_channel_desc, thread_id)

Parameters

Parameter	Description
vdec_channel_desc	Int, pointer address of the description of a video decoding channel. Call acl.media.vdec_create_channel_desc to create data of the aclvdecChannelDesc type in advance.
thread_id	Int, callback thread ID. NOTE: It is not allowed to pass the same thread ID for subscribing to VDEC callback functions on different devices in the same process. On a single device, the same thread ID can be specified for multiple VDEC channels. Compared with the scenario where each VDEC channel is processed by a separate thread, VDEC is less performant when multiple VDEC channels are processed in serial in a single thread.

Parameter

Description

vdec_channel_desc

Int, pointer address of the description of a video decoding channel.

Call acl.media.vdec_create_channel_desc to create data of the aclvdecChannelDesc type in advance.

thread_id

Int, callback thread ID.

NOTE:

It is not allowed to pass the same thread ID for subscribing to VDEC callback functions on different devices in the same process.

On a single device, the same thread ID can be specified for multiple VDEC channels. Compared with the scenario where each VDEC channel is processed by a separate thread, VDEC is less performant when multiple VDEC channels are processed in serial in a single thread.

Return Value

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Parent topic: VDEC