hi_mpi_sys_create_epoll

Applicability

Product	Supported
Atlas A3 training products / Atlas A3 inference products	√
Atlas A2 training products / Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	x

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.

hi_mpi_sys_create_epoll, hi_mpi_sys_ctl_epoll, hi_mpi_sys_wait_epoll, and hi_mpi_sys_close_epoll must be used together to operate the input and 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 file descriptors is restricted by the maximum number of files that can be opened at the same time in a task in the Linux OS, which can be viewed by using the ulimit -al command.

Returns

0: success
Other values: failure. For details, see Common Return Codes.

Restrictions

For the following models, only epoll APIs (like hi_mpi_sys_create_epoll) described in this document are available, and the epoll functions of the Linux OS are not available.
Atlas inference products in Ascend EP form

Atlas 200I/500 A2 inference products

Atlas A2 training products / Atlas A2 inference products

Atlas A3 training products / Atlas A3 inference products
For the following models, epoll APIs (like hi_mpi_sys_create_epoll) described in this document are equivalent to the epoll functions in the Linux OS.