hi_mpi_venc_query_status

Description

Queries the status of an encoding channel.

Restrictions

• Ensure that a channel has been created. Otherwise, a failure is returned.
• The output status points to the following information:
  • In the encoding channel status struct, left_pics indicates the number of remaining frames to be encoded. Before any attempt to reset an encoding channel, use this API call to ensure that all frames are encoded.
  • In the encoding channel status struct, left_stream_bytes indicates the number of remaining bytes in the stream buffer.

    Before any attempt to reset an encoding channel, use this API call to ensure that the stream is completely encoded.

  • In the encoding channel status struct, left_stream_frames indicates the number of remaining frames in the stream buffer.

    Before any attempt to reset an encoding channel, use this API call to ensure that the stream is completely encoded.

  • In the encoding channel status struct, cur_packs indicates the number of packets of the current frame. Ensure that cur_packs is greater than 0 before the hi_mpi_venc_get_stream call.

    For stream fetching in packet mode, the current frame could be incomplete. For stream fetching in frame mode, cur_packs indicates the number of packets of a complete frame (the value 0 indicates that no frame is available). If you want to fetch the streams by frames, query the number of packets for a complete frame by calling the query function after the select function is called successfully. In this case, cur_packs represents the number of packets contained in a current complete frame.

  • In the encoding channel status struct, left_recv_pics indicates the number of remaining frames to be received after the hi_mpi_venc_start_chn call.
  • In the encoding channel status struct, left_enc_pics indicates the number of remaining frames to be encoded after the hi_mpi_venc_start_chn call.
  • If no receive limit is specified in the hi_mpi_venc_start_chn call, the values of left_recv_pics and left_enc_pics are always 0.

Prototype

hi_s32 hi_mpi_venc_query_status(hi_venc_chn chn, hi_venc_chn_status *status)

Parameters

Returns

• 0: success
• Other values: failure. For details, see VENC/JPEGE Return Codes.