kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-11-10 20:08:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clear up documentation of AST_FRIENDLY_OFFSET in frame.h

Browse Source 
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@176697 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Mark Michelson
2009-02-17 21:40:09 +00:00
parent 57b89131a3
commit 6d60de7efa
1 changed files with 11 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
include/asterisk/frame.h
View File

@@ -194,9 +194,17 @@ struct ast_frame {
for this purpose instead of having to declare one on the stack */ for this purpose instead of having to declare one on the stack */
extern struct ast_frame ast_null_frame; extern struct ast_frame ast_null_frame;
#define AST_FRIENDLY_OFFSET 64 /*! It's polite for a a new frame to /*! \brief Offset into a frame's data buffer.
have this number of bytes for additional *
headers. */ * By providing some "empty" space prior to the actual data of an ast_frame,
* this gives any consumer of the frame ample space to prepend other necessary
* information without having to create a new buffer.
*
* As an example, RTP can use the data from an ast_frame and simply prepend the
* RTP header information into the space provided by AST_FRIENDLY_OFFSET instead
* of having to create a new buffer with the necessary space allocated.
*/
#define AST_FRIENDLY_OFFSET 64
#define AST_MIN_OFFSET 32 /*! Make sure we keep at least this much handy */ #define AST_MIN_OFFSET 32 /*! Make sure we keep at least this much handy */
/*! Need the header be free'd? */ /*! Need the header be free'd? */