0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: DTV.audio
0003
0004 .. _audio_fwrite:
0005
0006 =========================
0007 Digital TV audio write()
0008 =========================
0009
0010 Name
0011 ----
0012
0013 Digital TV audio write()
0014
0015 .. attention:: This ioctl is deprecated
0016
0017 Synopsis
0018 --------
0019
0020 .. c:function:: size_t write(int fd, const void *buf, size_t count)
0021
0022 Arguments
0023 ---------
0024
0025 .. flat-table::
0026 :header-rows: 0
0027 :stub-columns: 0
0028
0029 - .. row 1
0030
0031 - int fd
0032
0033 - File descriptor returned by a previous call to open().
0034
0035 - .. row 2
0036
0037 - void \*buf
0038
0039 - Pointer to the buffer containing the PES data.
0040
0041 - .. row 3
0042
0043 - size_t count
0044
0045 - Size of buf.
0046
0047 Description
0048 -----------
0049
0050 This system call can only be used if AUDIO_SOURCE_MEMORY is selected
0051 in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in
0052 PES format. If O_NONBLOCK is not specified the function will block
0053 until buffer space is available. The amount of data to be transferred is
0054 implied by count.
0055
0056 Return Value
0057 ------------
0058
0059 .. flat-table::
0060 :header-rows: 0
0061 :stub-columns: 0
0062
0063 - .. row 1
0064
0065 - ``EPERM``
0066
0067 - Mode AUDIO_SOURCE_MEMORY not selected.
0068
0069 - .. row 2
0070
0071 - ``ENOMEM``
0072
0073 - Attempted to write more data than the internal buffer can hold.
0074
0075 - .. row 3
0076
0077 - ``EBADF``
0078
0079 - fd is not a valid open file descriptor.