aclvdecGetChannelDesc Series

Applicability

Product

Supported

Atlas A3 training products/Atlas A3 inference products

Atlas A2 training products/Atlas A2 inference products

Atlas 200I/500 A2 inference products

Atlas inference products

Atlas training products

Description

Obtains the description of a video decoding channel.

Prototype

uint32_t aclvdecGetChannelDescChannelId(const aclvdecChannelDesc *channelDesc)
uint32_t aclvdecGetChannelDescThreadId(const aclvdecChannelDesc *channelDesc)
aclvdecCallback aclvdecGetChannelDescCallback(const aclvdecChannelDesc *channelDesc)
acldvppStreamFormat aclvdecGetChannelDescEnType(const aclvdecChannelDesc *channelDesc)
acldvppPixelFormat aclvdecGetChannelDescOutPicFormat(const aclvdecChannelDesc *channelDesc)
uint32_t aclvdecGetChannelDescOutPicWidth(const aclvdecChannelDesc *channelDesc)
uint32_t aclvdecGetChannelDescOutPicHeight(const aclvdecChannelDesc *channelDesc)
uint32_t aclvdecGetChannelDescRefFrameNum(const aclvdecChannelDesc *channelDesc)
uint32_t aclvdecGetChannelDescOutMode(const aclvdecChannelDesc *channelDesc)
uint32_t aclvdecGetChannelDescBitDepth(const aclvdecChannelDesc *channelDesc)

Parameters

Parameter

Input/Output

Description

channelDesc

Input

Pointer to the description of a video decoding channel.

Call the aclvdecCreateChannelDesc API to create data of the aclvdecChannelDesc type and call the aclvdecSetChannelDesc series APIs to set the attribute value of the video decoding channel description in advance.

Returns

Parameter

Description

channelId

Decoding channel ID.

Must be in the range of [0, 31] for the Atlas training products.

Must be in the range of [0, 255] for the Atlas inference products.

Must be in the range of [0, 255] for the Atlas 200I/500 A2 inference products.

Must be in the range of [0, 255] for the Atlas A2 training products/Atlas A2 inference products.

Must be in the range of [0, 255] for the Atlas A3 training products/Atlas A3 inference products.

threadId

Callback thread ID.

callback

Callback function.

For details, see aclvdecCallback.

enType

Video coding protocol: H.265 main level (0), H.264 baseline level (1), H.264 main level (2), or H.264 high level (3).

outPicFormat

YUV image storage format.

outPicWidth

Image width.

outPicHeight

Image height.

refFrameNum

Number of reference frames. Must be in the range of [0, 16].

In the current version of the Atlas training products, it is not supported to obtain this parameter value. The value obtained is invalid.

outMode

Whether to output frames in real time (that is, one frame is sent and decoded without depending on the input of subsequent frames). The options are as follows:

  • 0: delayed frame output mode. VDEC starts to output the decoding result only after receiving multiple frames in the stream.
  • 1: real-time frame output mode. VDEC starts to output the decoding result in real time after receiving one frame in the stream. Only H.264/H.265 standard streams with simple reference relationships are supported (no long-term reference frames or B-frames).

bitDepth

Video bit width.

Format range is as follows:

  • 0: 8-bit
  • 1: 10-bit

In the current version of the Atlas training products, it is not supported to obtain this parameter value. The value obtained is invalid.