[media] docs-rst: Convert DVB uAPI to use C function references
[cascardo/linux.git] / Documentation / media / uapi / dvb / video-get-navi.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _VIDEO_GET_NAVI:
4
5 ==============
6 VIDEO_GET_NAVI
7 ==============
8
9 Name
10 ----
11
12 VIDEO_GET_NAVI
13
14 .. attention:: This ioctl is deprecated.
15
16 Synopsis
17 --------
18
19 .. c:function:: int ioctl(fd, VIDEO_GET_NAVI , video_navi_pack_t *navipack)
20     :name: VIDEO_GET_NAVI
21
22
23 Arguments
24 ---------
25
26 .. flat-table::
27     :header-rows:  0
28     :stub-columns: 0
29
30
31     -  .. row 1
32
33        -  int fd
34
35        -  File descriptor returned by a previous call to open().
36
37     -  .. row 2
38
39        -  int request
40
41        -  Equals VIDEO_GET_NAVI for this command.
42
43     -  .. row 3
44
45        -  video_navi_pack_t \*navipack
46
47        -  PCI or DSI pack (private stream 2) according to section ??.
48
49
50 Description
51 -----------
52
53 This ioctl returns navigational information from the DVD stream. This is
54 especially needed if an encoded stream has to be decoded by the
55 hardware.
56
57
58 Return Value
59 ------------
60
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.
64
65
66
67 .. flat-table::
68     :header-rows:  0
69     :stub-columns: 0
70
71
72     -  .. row 1
73
74        -  ``EFAULT``
75
76        -  driver is not able to return navigational information