Changeset 38539 in vbox

Timestamp:

Aug 25, 2011 10:06:11 PM (14 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

73687

Message:

Runtime/SgBuf: Add new method to get the next segment from the S/G buffer

Location:

trunk

Files:

• include/iprt/mangling.h (modified) (1 diff)
• include/iprt/sg.h (modified) (1 diff)
• src/VBox/Runtime/common/misc/sg.cpp (modified) (1 diff)

trunk/include/iprt/mangling.h

@@ -1122 +1122 @@
 # define RTSgBufSegArrayCreate                          RT_MANGLER(RTSgBufSegArrayCreate)
 # define RTSgBufSet                                     RT_MANGLER(RTSgBufSet)
+# define RTSgBufGetNextSegment                          RT_MANGLER(RTSgBufGetNextSegment)
 # define RTSha1                                         RT_MANGLER(RTSha1)
 # define RTSha1Digest                                   RT_MANGLER(RTSha1Digest)

trunk/include/iprt/sg.h

@@ -102 +102 @@
  */
 RTDECL(void) RTSgBufClone(PRTSGBUF pSgBufNew, PCRTSGBUF pSgBufOld);
+
+/**
+ * Returns the next segment in the S/G buffer or NULL if no segment is left.
+ *
+ * @returns Pointer to the next segment in the S/G buffer.
+ * @param   pSgBuf       The S/G buffer.
+ * @param   pcbSeg       Where to store the size of the returned segment.
+ *                       Holds the number of bytes requested initially or 0 to
+ *                       indicate that the size doesn't matter.
+ *                       This may contain fewer bytes on success if the current segment
+ *                       is smaller than the amount of bytes requested.
+ *
+ * @note This operation advances the internal buffer pointer of both S/G buffers.
+ */
+RTDECL(void *) RTSgBufGetNextSegment(PRTSGBUF pSgBuf, size_t *pcbSeg);
 
 /**

trunk/src/VBox/Runtime/common/misc/sg.cpp

@@ -111 +111 @@
 
 
+RTDECL(void *) RTSgBufGetNextSegment(PRTSGBUF pSgBuf, size_t *pcbSeg)
+{
+    AssertPtrReturn(pSgBuf, NULL);
+    AssertPtrReturn(pcbSeg, NULL);
+
+    if (!*pcbSeg)
+        *pcbSeg = pSgBuf->cbSegLeft;
+
+    return sgBufGet(pSgBuf, pcbSeg);
+}
+
+
 RTDECL(size_t) RTSgBufCopy(PRTSGBUF pSgBufDst, PRTSGBUF pSgBufSrc, size_t cbCopy)
 {