VACodedBufferSegment: modify the semantics/description
authorAustin Yuan <shengquan.yuan@intel.com>
Tue, 28 Feb 2012 00:46:16 +0000 (19:46 -0500)
committerXiang, Haihao <haihao.xiang@intel.com>
Tue, 28 May 2013 08:19:08 +0000 (16:19 +0800)
VACodedBufferSegment may contain more than one NALs, and flag
VA_CODED_BUF_STATUS_SINGLE_NALU will be used to singal the
segment only contain one NAL

Signed-off-by: Austin Yuan <shengquan.yuan@intel.com>
va/va.h

diff --git a/va/va.h b/va/va.h
index 48ce784..6e41225 100644 (file)
--- a/va/va.h
+++ b/va/va.h
@@ -1556,12 +1556,23 @@ VAStatus vaBufferSetNumElements (
 #define VA_CODED_BUF_STATUS_AIR_MB_OVER_THRESHOLD      0xff0000
 
 /**
+ * \brief The coded buffer segment contains a single NAL unit. 
+ *
+ * This flag indicates that the coded buffer segment contains a
+ * single NAL unit. This flag might be useful to the user for 
+ * processing the coded buffer.
+ */
+#define VA_CODED_BUF_STATUS_SINGLE_NALU                 0x10000000     
+
+/**
  * \brief Coded buffer segment.
  *
  * #VACodedBufferSegment is an element of a linked list describing
- * some information on the coded buffer. The size of the linked list
- * shall be equal to the number of returned NAL units. That is, there
- * shall be as many coded buffer segments as NAL units.
+ * some information on the coded buffer. The coded buffer segment
+ * could contain either a single NAL unit, or more than one NAL unit. 
+ * It is recommended (but not required) to return a single NAL unit 
+ * in a coded buffer segment, and the implementation should set the 
+ * VA_CODED_BUF_STATUS_SINGLE_NALU status flag if that is the case.
  */
 typedef  struct _VACodedBufferSegment  {
     /**