aclvencSendFrame

The Atlas Training Series Product does not support this API.

Description

Feeds images to the encoder for encoding. This API is asynchronous.

Restrictions

  • This API is asynchronous. The API call delivers a task rather than executes a task. After this API is called, call the synchronization API (for example, aclrtSynchronizeStream) to ensure that the task is complete.
  • Ensure that a channel has been created. Otherwise, an error code is returned.
  • It is not allowed to send an empty stream packet with eos = 0 (stream length is 0 or stream address is empty).
  • When an empty image with eos = 1 is sent, the current encoding ends.
  • During encoding, the input buffer can be released only after the result is obtained from the aclvencCallback function.

Prototype

aclError aclvencSendFrame(aclvencChannelDesc *channelDesc,

acldvppPicDesc *input,

void *reserve,

aclvencFrameConfig *config,

void *userdata)

Parameters

Parameter

Input/Output

Description

channelDesc

Input

Pointer to the channel description.

Must be the same as the channelDesc argument passed to the aclvencCreateChannel call.

Specify the video encoding callback function in the channel description.

input

Input

Pointer to the input image description. The user needs to allocate input buffer in advance.

reserve

Input

Reserved.

config

Input

Pointer to the single-frame configuration.

userdata

Input

Pointer to the user-defined data.

Returns

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

See Also

For details about the API call sequence and example, see VENC.