From: Hans Verkuil <[email protected]>

Clarify in the buf_prepare/finish ops what the dma mapping status is of
the provided buffer.

Signed-off-by: Hans Verkuil <[email protected]>
---
 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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to