1 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.
2 .. c:namespace:: MC
3
4 .. _media_request_ioc_queue:
5
6 *****************************
7 ioctl MEDIA_REQUEST_IOC_QUEUE
8 *****************************
9
10 Name
11 ====
12
13 MEDIA_REQUEST_IOC_QUEUE - Queue a request
14
15 Synopsis
16 ========
17
18 .. c:macro:: MEDIA_REQUEST_IOC_QUEUE
19
20 ``int ioctl(int request_fd, MEDIA_REQUEST_IOC_
21
22 Arguments
23 =========
24
25 ``request_fd``
26 File descriptor returned by :ref:`MEDIA_IO
27
28 Description
29 ===========
30
31 If the media device supports :ref:`requests <m
32 this request ioctl can be used to queue a prev
33
34 If the request was successfully queued, then t
35 :ref:`polled <request-func-poll>` to wait for
36
37 If the request was already queued before, then
38 Other errors can be returned if the contents o
39 invalid or inconsistent data, see the next sec
40 common error codes. On error both the request
41
42 Once a request is queued, then the driver is r
43 errors that occur when the request is applied
44 exception is the ``EIO`` error which signals a
45 the application to stop streaming to reset the
46
47 It is not allowed to mix queuing requests with
48 (without a request). ``EBUSY`` will be returne
49 queued directly and you next try to queue a re
50
51 A request must contain at least one buffer, ot
52 return an ``ENOENT`` error.
53
54 Return Value
55 ============
56
57 On success 0 is returned, on error -1 and the
58 appropriately. The generic error codes are des
59 :ref:`Generic Error Codes <gen-errors>` chapte
60
61 EBUSY
62 The request was already queued or the appl
63 buffer directly, but later attempted to us
64 to mix the two APIs.
65 ENOENT
66 The request did not contain any buffers. A
67 to have at least one buffer. This can also
68 configuration is missing in the request.
69 ENOMEM
70 Out of memory when allocating internal dat
71 request.
72 EINVAL
73 The request has invalid data.
74 EIO
75 The hardware is in a bad state. To recover
76 stop streaming to reset the hardware state
77 streaming.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.