1 .. -*- coding: utf-8; mode: rst -*-
18 .. cpp:function:: int ioctl( int fd, int request = DMX_GET_EVENT, struct dmx_event *ev)
33 - File descriptor returned by a previous call to open().
39 - Equals DMX_GET_EVENT for this command.
43 - struct dmx_event \*ev
45 - Pointer to the location where the event is to be stored.
51 This ioctl call returns an event if available. If an event is not
52 available, the behavior depends on whether the device is in blocking or
53 non-blocking mode. In the latter case, the call fails immediately with
54 errno set to ``EWOULDBLOCK``. In the former case, the call blocks until an
55 event becomes available.
61 On success 0 is returned, on error -1 and the ``errno`` variable is set
62 appropriately. The generic error codes are described at the
63 :ref:`Generic Error Codes <gen-errors>` chapter.
76 - There is no event pending, and the device is in non-blocking mode.