Lines Matching +full:open +full:- +full:source
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later OR GPL-2.0
35 -----
39 ---------------------
46 .. code-block:: c
56 .. flat-table::
57 :header-rows: 0
58 :stub-columns: 0
60 - ..
62 - ``AUDIO_SOURCE_DEMUX``
64 - :cspan:`1` Selects the demultiplexer (fed either by the frontend
65 or the DVR device) as the source of the video stream.
67 - ..
69 - ``AUDIO_SOURCE_MEMORY``
71 - Selects the stream from the application that comes through
77 The audio stream source is set through the `AUDIO_SELECT_SOURCE`_ call
79 from an internal (demux) or external (user write) source.
81 The data fed to the decoder is also controlled by the PID-filter.
85 -----
89 ------------------
96 .. code-block:: c
107 .. flat-table::
108 :header-rows: 0
109 :stub-columns: 0
111 - ..
113 - ``AUDIO_STOPPED``
115 - Audio is stopped.
117 - ..
119 - ``AUDIO_PLAYING``
121 - Audio is currently playing.
123 - ..
125 - ``AUDIO_PAUSE``
127 - Audio is frozen.
136 -----
140 ----------------------
147 .. code-block:: c
160 .. flat-table::
161 :header-rows: 0
162 :stub-columns: 0
164 - ..
166 - ``AUDIO_STEREO``
168 - Stereo.
170 - ..
172 - ``AUDIO_MONO_LEFT``
174 - Mono, select left stereo channel as source.
176 - ..
178 - ``AUDIO_MONO_RIGHT``
180 - Mono, select right stereo channel as source.
182 - ..
184 - ``AUDIO_MONO``
186 - Mono source only.
188 - ..
190 - ``AUDIO_STEREO_SWAPPED``
192 - Stereo, swap L & R.
201 -----
205 -------------
212 .. code-block:: c
222 .. flat-table::
223 :header-rows: 0
224 :stub-columns: 0
226 - ..
228 - ``unsigned int volume_left``
230 - Volume left channel.
233 - ..
235 - ``unsigned int volume_right``
237 - Volume right channel.
247 -----
251 ------------
258 .. code-block:: c
273 .. flat-table::
274 :header-rows: 0
275 :stub-columns: 0
277 - ..
279 - :rspan:`2` ``int AV_sync_state``
281 - :cspan:`1` Shows if A/V synchronization is ON or OFF.
283 - ..
285 - TRUE ( != 0 )
287 - AV-sync ON.
289 - ..
291 - FALSE ( == 0 )
293 - AV-sync OFF.
295 - ..
297 - :rspan:`2` ``int mute_state``
299 - :cspan:`1` Indicates if audio is muted or not.
301 - ..
303 - TRUE ( != 0 )
305 - mute audio
307 - ..
309 - FALSE ( == 0 )
311 - unmute audio
313 - ..
315 - `audio_play_state_t`_ ``play_state``
317 - Current playback state.
319 - ..
321 - `audio_stream_source_t`_ ``stream_source``
323 - Current source of the data.
325 - ..
327 - :rspan:`2` ``int bypass_mode``
329 - :cspan:`1` Is the decoding of the current Audio stream in
332 - ..
334 - TRUE ( != 0 )
336 - Bypass disabled.
338 - ..
340 - FALSE ( == 0 )
342 - Bypass enabled.
344 - ..
346 - `audio_mixer_t`_ ``mixer_state``
348 - Current volume settings.
357 -----
361 ---------------
366 .. code-block:: c
381 .. flat-table::
382 :header-rows: 0
383 :stub-columns: 0
385 - ..
387 - ``AUDIO_CAP_DTS``
389 - :cspan:`1` The hardware accepts DTS audio tracks.
391 - ..
393 - ``AUDIO_CAP_LPCM``
395 - The hardware accepts uncompressed audio with
396 Linear Pulse-Code Modulation (LPCM)
398 - ..
400 - ``AUDIO_CAP_MP1``
402 - The hardware accepts MPEG-1 Audio Layer 1.
404 - ..
406 - ``AUDIO_CAP_MP2``
408 - The hardware accepts MPEG-1 Audio Layer 2.
411 - ..
413 - ``AUDIO_CAP_MP3``
415 - The hardware accepts MPEG-1 Audio Layer III.
418 - ..
420 - ``AUDIO_CAP_AAC``
422 - The hardware accepts AAC (Advanced Audio Coding).
424 - ..
426 - ``AUDIO_CAP_OGG``
428 - The hardware accepts Vorbis audio tracks.
430 - ..
432 - ``AUDIO_CAP_SDDS``
434 - The hardware accepts Sony Dynamic Digital Sound (SDDS).
436 - ..
438 - ``AUDIO_CAP_AC3``
440 - The hardware accepts Dolby Digital ATSC A/52 audio.
441 Also known as AC-3.
450 -----
458 ----------
465 .. code-block:: c
472 .. flat-table::
473 :header-rows: 0
474 :stub-columns: 0
476 - ..
478 - ``int fd``
480 - File descriptor returned by a previous call to `open()`_.
482 - ..
484 - ``int request``
486 - :cspan:`1` Equals ``AUDIO_STOP`` for this command.
500 On success 0 is returned, on error -1 and the ``errno`` variable is set
502 :ref:`Generic Error Codes <gen-errors>` chapter.
505 -----
509 ----------
516 .. code-block:: c
523 .. flat-table::
524 :header-rows: 0
525 :stub-columns: 0
527 - ..
529 - ``int fd``
531 - File descriptor returned by a previous call to `open()`_.
533 - ..
535 - ``int request``
537 - :cspan:`1` Equals ``AUDIO_PLAY`` for this command.
546 from the selected source.
551 On success 0 is returned, on error -1 and the ``errno`` variable is set
553 :ref:`Generic Error Codes <gen-errors>` chapter.
556 -----
560 -----------
567 .. code-block:: c
574 .. flat-table::
575 :header-rows: 0
576 :stub-columns: 0
578 - ..
580 - ``int fd``
582 - :cspan:`1` File descriptor returned by a previous call
583 to `open()`_.
585 - ..
587 - ``int request``
589 - Equals ``AUDIO_PAUSE`` for this command.
604 On success 0 is returned, on error -1 and the ``errno`` variable is set
606 :ref:`Generic Error Codes <gen-errors>` chapter.
609 -----
613 --------------
620 .. code-block:: c
627 .. flat-table::
628 :header-rows: 0
629 :stub-columns: 0
631 - ..
633 - ``int fd``
635 - :cspan:`1` File descriptor returned by a previous call
636 to `open()`_.
638 - ..
640 - ``int request``
642 - Equals ``AUDIO_CONTINUE`` for this command.
656 On success 0 is returned, on error -1 and the ``errno`` variable is set
658 :ref:`Generic Error Codes <gen-errors>` chapter.
661 -----
665 -------------------
672 .. code-block:: c
675 audio_stream_source_t source)
680 .. flat-table::
681 :header-rows: 0
682 :stub-columns: 0
684 - ..
686 - ``int fd``
688 - :cspan:`1` File descriptor returned by a previous call
689 to `open()`_.
691 - ..
693 - ``int request``
695 - Equals ``AUDIO_SELECT_SOURCE`` for this command.
697 - ..
699 - `audio_stream_source_t`_ ``source``
701 - Indicates the source that shall be used for the Audio stream.
709 This ioctl call informs the audio device which source shall be used for
713 is directly transferred from the onboard demux-device to the decoder.
714 Note: This only supports DVB-devices with one demux and one decoder so far.
719 On success 0 is returned, on error -1 and the ``errno`` variable is set
721 :ref:`Generic Error Codes <gen-errors>` chapter.
724 -----
728 --------------
735 .. code-block:: c
742 .. flat-table::
743 :header-rows: 0
744 :stub-columns: 0
746 - ..
748 - ``int fd``
750 - :cspan:`1` File descriptor returned by a previous call
751 to `open()`_.
753 - ..
755 - ``int request``
757 - :cspan:`1` Equals ``AUDIO_SET_MUTE`` for this command.
759 - ..
761 - :rspan:`2` ``int state``
763 - :cspan:`1` Indicates if audio device shall mute or not.
765 - ..
767 - TRUE ( != 0 )
769 - mute audio
771 - ..
773 - FALSE ( == 0 )
775 - unmute audio
793 On success 0 is returned, on error -1 and the ``errno`` variable is set
795 :ref:`Generic Error Codes <gen-errors>` chapter.
798 -----
802 -----------------
809 .. code-block:: c
816 .. flat-table::
817 :header-rows: 0
818 :stub-columns: 0
820 - ..
822 - ``int fd``
824 - :cspan:`1` File descriptor returned by a previous call
825 to `open()`_.
827 - ..
829 - ``int request``
831 - :cspan:`1` Equals ``AUDIO_AV_SYNC`` for this command.
833 - ..
835 - :rspan:`2` ``int state``
837 - :cspan:`1` Tells the DVB subsystem if A/V synchronization
840 - ..
842 - TRUE ( != 0 )
844 - AV-sync ON.
846 - ..
848 - FALSE ( == 0 )
850 - AV-sync OFF.
864 On success 0 is returned, on error -1 and the ``errno`` variable is set
866 :ref:`Generic Error Codes <gen-errors>` chapter.
869 -----
873 ---------------------
880 .. code-block:: c
887 .. flat-table::
888 :header-rows: 0
889 :stub-columns: 0
891 - ..
893 - ``int fd``
895 - :cspan:`1` File descriptor returned by a previous call
896 to `open()`_.
898 - ..
900 - ``int request``
902 - :cspan:`1` Equals ``AUDIO_SET_BYPASS_MODE`` for this command.
904 - ..
906 - :rspan:`2` ``int mode``
908 - :cspan:`1` Enables or disables the decoding of the current
910 - ..
912 - TRUE ( != 0 )
914 - Disable bypass
916 - ..
918 - FALSE ( == 0 )
920 - Enable bypass
937 On success 0 is returned, on error -1 and the ``errno`` variable is set
939 :ref:`Generic Error Codes <gen-errors>` chapter.
942 -----
946 --------------------
953 .. code-block:: c
961 .. flat-table::
962 :header-rows: 0
963 :stub-columns: 0
965 - ..
967 - ``int fd``
969 - :cspan:`1` File descriptor returned by a previous call
970 to `open()`_.
972 - ..
974 - ``int request``
976 - Equals ``AUDIO_CHANNEL_SELECT`` for this command.
978 - ..
980 - `audio_channel_select_t`_ ``ch``
982 - Select the output format of the audio (mono left/right, stereo).
999 On success 0 is returned, on error -1 and the ``errno`` variable is set
1001 :ref:`Generic Error Codes <gen-errors>` chapter.
1004 -----
1008 ----------------
1015 .. code-block:: c
1023 .. flat-table::
1024 :header-rows: 0
1025 :stub-columns: 0
1027 - ..
1029 - ``int fd``
1031 - :cspan:`1` File descriptor returned by a previous call
1032 to `open()`_.
1034 - ..
1036 - ``int request``
1038 - Equals AUDIO_GET_STATUS for this command.
1040 - ..
1042 - ``struct`` `audio_status`_ ``*status``
1044 - Returns the current state of Audio Device.
1058 On success 0 is returned, on error -1 and the ``errno`` variable is set
1060 :ref:`Generic Error Codes <gen-errors>` chapter.
1063 -----
1067 ----------------------
1074 .. code-block:: c
1082 .. flat-table::
1083 :header-rows: 0
1084 :stub-columns: 0
1086 - ..
1088 - ``int fd``
1090 - :cspan:`1` File descriptor returned by a previous call
1091 to `open()`_.
1093 - ..
1095 - ``int request``
1097 - Equals ``AUDIO_GET_CAPABILITIES`` for this command.
1099 - ..
1101 - ``unsigned int *cap``
1103 - Returns a bit array of supported sound formats.
1118 On success 0 is returned, on error -1 and the ``errno`` variable is set
1120 :ref:`Generic Error Codes <gen-errors>` chapter.
1123 -----
1127 ------------------
1134 .. code-block:: c
1141 .. flat-table::
1142 :header-rows: 0
1143 :stub-columns: 0
1145 - ..
1147 - ``int fd``
1149 - :cspan:`1` File descriptor returned by a previous call
1150 to `open()`_.
1152 - ..
1154 - ``int request``
1156 - Equals ``AUDIO_CLEAR_BUFFER`` for this command.
1170 On success 0 is returned, on error -1 and the ``errno`` variable is set
1172 :ref:`Generic Error Codes <gen-errors>` chapter.
1175 -----
1179 ------------
1186 .. code-block:: c
1193 .. flat-table::
1194 :header-rows: 0
1195 :stub-columns: 0
1197 - ..
1199 - ``int fd``
1201 - :cspan:`1` File descriptor returned by a previous call
1202 to `open()`_.
1204 - ..
1206 - ``int request``
1208 - Equals ``AUDIO_SET_ID`` for this command.
1210 - ..
1212 - ``int id``
1214 - Audio sub-stream id.
1222 This ioctl selects which sub-stream is to be decoded if a program or
1227 See ITU-T H.222.0 | ISO/IEC 13818-1 for further description.
1230 id just the sub-stream id of the audio stream and only the first 5 bits
1236 On success 0 is returned, on error -1 and the ``errno`` variable is set
1238 :ref:`Generic Error Codes <gen-errors>` chapter.
1241 -----
1245 ---------------
1252 .. code-block:: c
1259 .. flat-table::
1260 :header-rows: 0
1261 :stub-columns: 0
1263 - ..
1265 - ``int fd``
1267 - :cspan:`1` File descriptor returned by a previous call
1268 to `open()`_.
1270 - ..
1272 - ``int request``
1274 - Equals ``AUDIO_SET_MIXER`` for this command.
1276 - ..
1278 - ``audio_mixer_t *mix``
1280 - Mixer settings.
1293 On success 0 is returned, on error -1 and the ``errno`` variable is set
1295 :ref:`Generic Error Codes <gen-errors>` chapter.
1298 -----
1302 --------------------
1309 .. code-block:: c
1316 .. flat-table::
1317 :header-rows: 0
1318 :stub-columns: 0
1320 - ..
1322 - ``int fd``
1324 - :cspan:`1` File descriptor returned by a previous call
1325 to `open()`_.
1327 - ..
1329 - ``int request``
1331 - Equals ``AUDIO_SET_STREAMTYPE`` for this command.
1333 - ..
1335 - ``int type``
1337 - Stream type.
1346 is useful if the stream offers several audio sub-streams like LPCM and
1349 Stream types defined in ITU-T H.222.0 | ISO/IEC 13818-1 are used.
1355 On success 0 is returned, on error -1 and the ``errno`` variable is set
1357 :ref:`Generic Error Codes <gen-errors>` chapter.
1359 .. flat-table::
1360 :header-rows: 0
1361 :stub-columns: 0
1363 - ..
1365 - ``EINVAL``
1367 - Type is not a valid or supported stream type.
1370 -----
1374 ------------------------------
1381 .. code-block:: c
1389 .. flat-table::
1390 :header-rows: 0
1391 :stub-columns: 0
1393 - ..
1395 - ``int fd``
1397 - :cspan:`1` File descriptor returned by a previous call
1398 to `open()`_.
1400 - ..
1402 - ``int request``
1404 - Equals ``AUDIO_BILINGUAL_CHANNEL_SELECT`` for this command.
1406 - ..
1408 - ``audio_channel_select_t ch``
1410 - Select the output format of the audio (mono left/right, stereo).
1428 On success 0 is returned, on error -1 and the ``errno`` variable is set
1430 :ref:`Generic Error Codes <gen-errors>` chapter.
1433 -----
1436 open()
1437 ------
1442 .. code-block:: c
1446 .. c:function:: int open(const char *deviceName, int flags) argument
1451 .. flat-table::
1452 :header-rows: 0
1453 :stub-columns: 0
1455 - ..
1457 - ``const char *deviceName``
1459 - Name of specific audio device.
1461 - ..
1463 - :rspan:`3` ``int flags``
1465 - :cspan:`1` A bit-wise OR of the following flags:
1467 - ..
1469 - ``O_RDONLY``
1471 - read-only access
1473 - ..
1475 - ``O_RDWR``
1477 - read/write access
1479 - ..
1481 - ``O_NONBLOCK``
1482 - | Open in non-blocking mode
1489 ``/dev/dvb/adapter0/audio0``) for subsequent use. When an open() call has argument
1491 blocking or non-blocking mode is described in the documentation for
1493 of the open() call itself. A device opened in blocking mode can later be
1494 put into non-blocking mode (and vice versa) using the F_SETFL command
1496 the Linux manual page for fcntl. Only one user can open the Audio Device
1497 in O_RDWR mode. All other attempts to open the device in this mode will
1505 .. flat-table::
1506 :header-rows: 0
1507 :stub-columns: 0
1509 - ..
1511 - ``ENODEV``
1513 - Device driver not loaded/available.
1515 - ..
1517 - ``EBUSY``
1519 - Device or resource busy.
1521 - ..
1523 - ``EINVAL``
1525 - Invalid argument.
1528 -----
1532 -------
1542 .. flat-table::
1543 :header-rows: 0
1544 :stub-columns: 0
1546 - ..
1548 - ``int fd``
1550 - :cspan:`1` File descriptor returned by a previous call
1551 to `open()`_.
1561 .. flat-table::
1562 :header-rows: 0
1563 :stub-columns: 0
1565 - ..
1567 - ``EBADF``
1569 - Fd is not a valid open file descriptor.
1571 -----
1575 -------
1580 .. code-block:: c
1587 .. flat-table::
1588 :header-rows: 0
1589 :stub-columns: 0
1591 - ..
1593 - ``int fd``
1595 - :cspan:`1` File descriptor returned by a previous call
1596 to `open()`_.
1598 - ..
1600 - ``void *buf``
1602 - Pointer to the buffer containing the PES data.
1604 - ..
1606 - ``size_t count``
1608 - Size of buf.
1622 .. flat-table::
1623 :header-rows: 0
1624 :stub-columns: 0
1626 - ..
1628 - ``EPERM``
1630 - :cspan:`1` Mode ``AUDIO_SOURCE_MEMORY`` not selected.
1632 - ..
1634 - ``ENOMEM``
1636 - Attempted to write more data than the internal buffer can hold.
1638 - ..
1640 - ``EBADF``
1642 - Fd is not a valid open file descriptor.