1*793e52d4SMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2*793e52d4SMauro Carvalho Chehab.. c:namespace:: DTV.video
3*793e52d4SMauro Carvalho Chehab
4*793e52d4SMauro Carvalho Chehab.. _VIDEO_GET_PTS:
5*793e52d4SMauro Carvalho Chehab
6*793e52d4SMauro Carvalho Chehab=============
7*793e52d4SMauro Carvalho ChehabVIDEO_GET_PTS
8*793e52d4SMauro Carvalho Chehab=============
9*793e52d4SMauro Carvalho Chehab
10*793e52d4SMauro Carvalho ChehabName
11*793e52d4SMauro Carvalho Chehab----
12*793e52d4SMauro Carvalho Chehab
13*793e52d4SMauro Carvalho ChehabVIDEO_GET_PTS
14*793e52d4SMauro Carvalho Chehab
15*793e52d4SMauro Carvalho Chehab.. attention:: This ioctl is deprecated.
16*793e52d4SMauro Carvalho Chehab
17*793e52d4SMauro Carvalho ChehabSynopsis
18*793e52d4SMauro Carvalho Chehab--------
19*793e52d4SMauro Carvalho Chehab
20*793e52d4SMauro Carvalho Chehab.. c:macro:: VIDEO_GET_PTS
21*793e52d4SMauro Carvalho Chehab
22*793e52d4SMauro Carvalho Chehab``int ioctl(int fd, VIDEO_GET_PTS, __u64 *pts)``
23*793e52d4SMauro Carvalho Chehab
24*793e52d4SMauro Carvalho ChehabArguments
25*793e52d4SMauro Carvalho Chehab---------
26*793e52d4SMauro Carvalho Chehab
27*793e52d4SMauro Carvalho Chehab.. flat-table::
28*793e52d4SMauro Carvalho Chehab    :header-rows:  0
29*793e52d4SMauro Carvalho Chehab    :stub-columns: 0
30*793e52d4SMauro Carvalho Chehab
31*793e52d4SMauro Carvalho Chehab    -  .. row 1
32*793e52d4SMauro Carvalho Chehab
33*793e52d4SMauro Carvalho Chehab       -  int fd
34*793e52d4SMauro Carvalho Chehab
35*793e52d4SMauro Carvalho Chehab       -  File descriptor returned by a previous call to open().
36*793e52d4SMauro Carvalho Chehab
37*793e52d4SMauro Carvalho Chehab    -  .. row 2
38*793e52d4SMauro Carvalho Chehab
39*793e52d4SMauro Carvalho Chehab       -  int request
40*793e52d4SMauro Carvalho Chehab
41*793e52d4SMauro Carvalho Chehab       -  Equals VIDEO_GET_PTS for this command.
42*793e52d4SMauro Carvalho Chehab
43*793e52d4SMauro Carvalho Chehab    -  .. row 3
44*793e52d4SMauro Carvalho Chehab
45*793e52d4SMauro Carvalho Chehab       -  __u64 \*pts
46*793e52d4SMauro Carvalho Chehab
47*793e52d4SMauro Carvalho Chehab       -  Returns the 33-bit timestamp as defined in ITU T-REC-H.222.0 /
48*793e52d4SMauro Carvalho Chehab	  ISO/IEC 13818-1.
49*793e52d4SMauro Carvalho Chehab
50*793e52d4SMauro Carvalho Chehab	  The PTS should belong to the currently played frame if possible,
51*793e52d4SMauro Carvalho Chehab	  but may also be a value close to it like the PTS of the last
52*793e52d4SMauro Carvalho Chehab	  decoded frame or the last PTS extracted by the PES parser.
53*793e52d4SMauro Carvalho Chehab
54*793e52d4SMauro Carvalho ChehabDescription
55*793e52d4SMauro Carvalho Chehab-----------
56*793e52d4SMauro Carvalho Chehab
57*793e52d4SMauro Carvalho ChehabThis ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
58*793e52d4SMauro Carvalho Chehabthis ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_PTS``
59*793e52d4SMauro Carvalho Chehabcontrol.
60*793e52d4SMauro Carvalho Chehab
61*793e52d4SMauro Carvalho ChehabThis ioctl call asks the Video Device to return the current PTS
62*793e52d4SMauro Carvalho Chehabtimestamp.
63*793e52d4SMauro Carvalho Chehab
64*793e52d4SMauro Carvalho ChehabReturn Value
65*793e52d4SMauro Carvalho Chehab------------
66*793e52d4SMauro Carvalho Chehab
67*793e52d4SMauro Carvalho ChehabOn success 0 is returned, on error -1 and the ``errno`` variable is set
68*793e52d4SMauro Carvalho Chehabappropriately. The generic error codes are described at the
69*793e52d4SMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter.
70