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 training product	x
Atlas inference product	√
Atlas 200I/500 A2 inference product	√

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.

Prototype

C Prototype

hi_s32 hi_mpi_sys_create_epoll(hi_s32 size, hi_s32 *epoll_fd);

Python Function

epoll_fd, ret = acl.himpi.sys_create_epoll(size)

Parameters

None

Return Value

Return Value	Description
epoll_fd	Int, pointer address of 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.
ret	Int, error code. 0 indicates success. Other values indicate failure. For details, see Common Return Codes.

Description

epoll_fd

Int, pointer address of 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.

ret

Int, error code.

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

Restrictions

acl.himpi.sys_create_epoll, acl.himpi.sys_ctl_epoll, acl.himpi.sys_wait_epoll, and acl.himpi.sys_close_epoll must be used in conjunction. Use the epoll programming model to operate the input/output data of DVPP channels.

Atlas inference product: In Ascend EP, only the Epoll API (for example, acl.himpi.sys_create_epoll) can be used. The Epoll function of the Linux OS cannot be used.
Atlas A2 training product/Atlas A2 inference product: Only the Epoll API (for example, acl.himpi.sys_create_epoll) can be used. The Epoll function of the Linux OS cannot be used.
Atlas 200I/500 A2 inference product: Only the Epoll API (for example, acl.himpi.sys_create_epoll) can be used. The Epoll function of the Linux OS cannot be used.
Atlas A3 training product/Atlas A3 inference product: Only the Epoll API (for example, acl.himpi.sys_create_epoll) provided by PyACL can be used. The Epoll function of the Linux OS cannot be used.
The VPC function does not support this API.

Parent topic: Common APIs