From: Hans Verkuil <hans.verkuil@xxxxxxxxx>
Clarify in the buf_prepare/finish ops what the dma mapping status is of
the provided buffer.
Signed-off-by: Hans Verkuil <hans.verkuil@xxxxxxxxx>
---
include/media/videobuf2-core.h | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
diff --git a/include/media/videobuf2-core.h b/include/media/videobuf2-core.h
index a0dedc1..169e111 100644
--- a/include/media/videobuf2-core.h
+++ b/include/media/videobuf2-core.h
@@ -274,12 +274,14 @@ struct vb2_buffer {
* operation in this callback; drivers that support
* VIDIOC_CREATE_BUFS must also validate the buffer size;
* if an error is returned, the buffer will not be queued
- * in driver; optional.
+ * in driver; any necessary DMA mapping action will have
+ * been done before this is called; optional.
* @buf_finish: called before every dequeue of the buffer back to
* userspace; drivers may perform any operations required
- * before userspace accesses the buffer; optional. Note:
- * this op can be called as well when vb2_is_streaming()
- * returns false!
+ * before userspace accesses the buffer; any necessary DMA
+ * unmapping action will have been done before this is
+ * called; optional. Note: this op can be called as well
+ * when vb2_is_streaming() returns false!
* @buf_cleanup: called once before the buffer is freed; drivers may
* perform any additional cleanup; optional.
* @start_streaming: called once to enter 'streaming' state; the driver may
--
1.9.0
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
