aclvencSendFrame
The
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.