slightly clarify docu of read() wrt. underrun

This commit is contained in:
Oswald Buddenhagen
2024-02-01 01:50:27 +01:00
committed by Lars Immisch
parent 16345a139a
commit 7d9c16618b
+6 -3
View File
@@ -324,9 +324,12 @@ PCM objects have the following methods:
``(0,'')`` if no new period has become available since the last ``(0,'')`` if no new period has become available since the last
call to read. call to read.
In case of an overrun, this function will return a negative size: :const:`-EPIPE`. In case of a buffer overrun, this function will return the negative
This indicates that data was lost, even if the operation itself succeeded. size :const:`-EPIPE`, and no data is read.
Try using a larger periodsize. This indicates that data was lost. To resume capturing, just call read
again, but note that the stream was already corrupted.
To avoid the problem in the future, try using a larger period size
and/or more periods, at the cost of higher latency.
.. method:: PCM.write(data) .. method:: PCM.write(data)