aclvdecSetChannelDesc Series

Description

Sets the description of a video decoding channel.

Prototype

aclError aclvdecSetChannelDescChannelId(aclvdecChannelDesc *channelDesc, uint32_t channelId)

aclError aclvdecSetChannelDescThreadId(aclvdecChannelDesc *channelDesc, uint64_t threadId)

aclError aclvdecSetChannelDescCallback(aclvdecChannelDesc *channelDesc, aclvdecCallback callback)

aclError aclvdecSetChannelDescEnType(aclvdecChannelDesc *channelDesc, acldvppStreamFormat enType)

aclError aclvdecSetChannelDescOutPicFormat(aclvdecChannelDesc *channelDesc, acldvppPixelFormat outPicFormat)

aclError aclvdecSetChannelDescOutPicWidth(aclvdecChannelDesc *channelDesc, uint32_t outPicWidth)

aclError aclvdecSetChannelDescOutPicHeight(aclvdecChannelDesc *channelDesc, uint32_t outPicHeight)

aclError aclvdecSetChannelDescRefFrameNum(aclvdecChannelDesc *channelDesc, uint32_t refFrameNum)

aclError aclvdecSetChannelDescOutMode(aclvdecChannelDesc *channelDesc, uint32_t outMode)

aclError aclvdecSetChannelDescBitDepth(aclvdecChannelDesc *channelDesc, uint32_t bitDepth)

Parameters

Parameter

Input/Output

Description

channelDesc

Output

Pointer to the description of a video decoding channel.

Call aclvdecCreateChannelDesc to create data of the aclvdecChannelDesc type in advance.

channelId

Input

Channel ID.

Must be in the range of [0, 31] for the Atlas 200/300/500 Inference Product.

Must be in the range of [0, 31] for the Atlas Training Series Product.

threadId

Input

Callback thread ID.

NOTE:

Do not 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.

callback

Input

Decoding callback function.

For details, see aclvdecCallback.

enType

Input

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

Input

Storage format of the output image. For details about the supported formats, see Restrictions on Stream/Image Formats, Width and Height Alignment, and Buffers.

Defaults to YUV420SP NV12.

outPicWidth

Input

Maximum output width.

Defaults to 1920 for the Atlas 200/300/500 Inference Product.

Defaults to 1920 for the Ascend 310 AI Processor.

outPicHeight

Input

Maximum output height

Defaults to 1120 for the Atlas 200/300/500 Inference Product.

Defaults to 1120 for the Ascend 310 AI Processor.

refFrameNum

Input

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

Not configurable for the Atlas 200/300/500 Inference Product in the current version.

Not configurable for the Atlas Training Series Product in the current version.

outMode

Input

Frame output mode.

Value range:
  • 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

Input

Video bit depth.

Value range:
  • 0: 8-bit
  • 1: 10-bit (default)

Not configurable for the Atlas 200/300/500 Inference Product in the current version.

Not configurable for the Atlas Training Series Product in the current version.

Returns

The value 0 indicates success, and other values indicate failure. For details, see aclError.