hi_mpi_sys_create_epoll

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Function Description

Creates an epoll instance for media data processing to allow you to use the epoll programming model to operate the input and output data of the media data processing channel.

The hi_mpi_sys_create_epoll, hi_mpi_sys_ctl_epoll, hi_mpi_sys_wait_epoll, and hi_mpi_sys_close_epoll APIs must be used together to operate the input/output data of the media data processing channel by using the epoll programming model. The VPC function does not support this API.

Prototype

hi_s32 hi_mpi_sys_create_epoll(hi_s32 size, hi_s32 *epoll_fd)

Parameters

Parameter

Input/Output

Description

size

Input

Maximum number of DVPP channel file descriptors that can be processed by the epoll instance. This field is reserved. Set it to a positive number.

epoll_fd

Output

Pointer to the file descriptor of an epoll instance. The number of handles is restricted by the open files (maximum number of files that can be opened at the same time in a task) of the Linux operating system. You can run the ulimit -a command to view open files.

Returns

Restrictions

  • For the following models, only the epoll interfaces (for example, hi_mpi_sys_create_epoll) described in this document can be used. The epoll function of the Linux operating system cannot be used.

    Ascend EP form of Atlas inference product

    Atlas 200I/500 A2 inference product

    Atlas A2 training product / Atlas A2 inference product

    Atlas A3 training product / Atlas A3 inference product

    Atlas 350 Accelerator Card

  • For the following models, using the Epoll interface (for example, hi_mpi_sys_create_epoll) described in this document is equivalent to using the Epoll function of the Linux operating system.

    Ctrl CPU open form of the Atlas inference product

See Also

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