diff --git a/media/java/android/media/tv/tuner/dvr/DvrPlayback.java b/media/java/android/media/tv/tuner/dvr/DvrPlayback.java index 7c15bb74a94b1..dbd9db4b6a454 100644 --- a/media/java/android/media/tv/tuner/dvr/DvrPlayback.java +++ b/media/java/android/media/tv/tuner/dvr/DvrPlayback.java @@ -89,6 +89,9 @@ public class DvrPlayback implements AutoCloseable { /** * Attaches a filter to DVR interface for recording. * + *

There can be multiple filters attached. Attached filters are independent, so the order + * doesn't matter. + * * @param filter the filter to be attached. * @return result status of the operation. */ @@ -135,6 +138,7 @@ public class DvrPlayback implements AutoCloseable { * Stops DVR. * *

Stops consuming playback data or producing data for recording. + *

Does nothing if the filter is stopped or not started.

* * @return result status of the operation. */ @@ -164,9 +168,14 @@ public class DvrPlayback implements AutoCloseable { } /** - * Sets file descriptor to read/write data. + * Sets file descriptor to read data. * - * @param fd the file descriptor to read/write data. + *

When a read operation of the filter object is happening, this method should not be + * called. + * + * @param fd the file descriptor to read data. + * @see #read(long) + * @see #read(byte[], long, long) */ public void setFileDescriptor(@NonNull ParcelFileDescriptor fd) { nativeSetFileDescriptor(fd.getFd()); diff --git a/media/java/android/media/tv/tuner/dvr/DvrRecorder.java b/media/java/android/media/tv/tuner/dvr/DvrRecorder.java index 52ef5e63389f3..c1c6c624454e5 100644 --- a/media/java/android/media/tv/tuner/dvr/DvrRecorder.java +++ b/media/java/android/media/tv/tuner/dvr/DvrRecorder.java @@ -50,6 +50,9 @@ public class DvrRecorder implements AutoCloseable { /** * Attaches a filter to DVR interface for recording. * + *

There can be multiple filters attached. Attached filters are independent, so the order + * doesn't matter. + * * @param filter the filter to be attached. * @return result status of the operation. */ @@ -84,6 +87,7 @@ public class DvrRecorder implements AutoCloseable { * Starts DVR. * *

Starts consuming playback data or producing data for recording. + *

Does nothing if the filter is stopped or not started.

* * @return result status of the operation. */ @@ -125,9 +129,14 @@ public class DvrRecorder implements AutoCloseable { } /** - * Sets file descriptor to read/write data. + * Sets file descriptor to write data. * - * @param fd the file descriptor to read/write data. + *

When a write operation of the filter object is happening, this method should not be + * called. + * + * @param fd the file descriptor to write data. + * @see #write(long) + * @see #write(byte[], long, long) */ public void setFileDescriptor(@NonNull ParcelFileDescriptor fd) { nativeSetFileDescriptor(fd.getFd());