3.2.10. DMX_GET_EVENT

3.2.10.1. Name

DMX_GET_EVENT

3.2.10.2. Synopsis

int ioctl(int fd, int request = DMX_GET_EVENT, struct dmx_event *ev)

3.2.10.3. Arguments

int fd File descriptor returned by a previous call to open().
int request Equals DMX_GET_EVENT for this command.
struct dmx_event *ev Pointer to the location where the event is to be stored.

3.2.10.4. Description

This ioctl call returns an event if available. If an event is not available, the behavior depends on whether the device is in blocking or non-blocking mode. In the latter case, the call fails immediately with errno set to EWOULDBLOCK. In the former case, the call blocks until an event becomes available.

3.2.10.5. Return Value

On success 0 is returned, on error -1 and the errno variable is set appropriately. The generic error codes are described at the Generic Error Codes chapter.

EWOULDBLOCK There is no event pending, and the device is in non-blocking mode.