hi_mpi_sys_create_epoll

Applicable Products

Product

Supported

Ascend 950PR / Ascend 950DT

√

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

☓

Function

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 through 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 ile 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 -a command.

Returns

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

    Ascend 950PR / Ascend 950DT

  • 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.

    Atlas inference products in Open Ctrl CPU form

Reference

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