[FFmpeg-cvslog] qsv: document AVQSVContext members

[Anton Khirnov]

ffmpeg | branch: master | Anton Khirnov <anton at khirnov.net> | Mon Jul 20 14:30:07 2015 +0200| [d0c8c380ecf3d9bb16621a4fb59ebbcde301002a] | committer: Anton Khirnov

qsv: document AVQSVContext members

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=d0c8c380ecf3d9bb16621a4fb59ebbcde301002a
---

 libavcodec/qsv.h |   19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/libavcodec/qsv.h b/libavcodec/qsv.h
index 6532594..922b858 100644
--- a/libavcodec/qsv.h
+++ b/libavcodec/qsv.h
@@ -23,10 +23,29 @@
 
 #include <mfx/mfxvideo.h>
 
+/**
+ * This struct is used for communicating QSV parameters between libavcodec and
+ * the caller. It is managed by the caller and must be assigned to
+ * AVCodecContext.hwaccel_context.
+ * - decoding: hwaccel_context must be set on return from the get_format()
+ *             callback
+ * - encoding: hwaccel_context must be set before avcodec_open2()
+ */
 typedef struct AVQSVContext {
+    /**
+     * If non-NULL, the session to use for encoding or decoding.
+     * Otherwise, libavcodec will try to create an internal session.
+     */
     mfxSession session;
+
+    /**
+     * The IO pattern to use.
+     */
     int iopattern;
 
+    /**
+     * Extra buffers to pass to encoder or decoder initialization.
+     */
     mfxExtBuffer **ext_buffers;
     int         nb_ext_buffers;
 } AVQSVContext;