diff options
author | mmichelson <mmichelson@f38db490-d61c-443f-a65b-d21fe96a405b> | 2009-02-17 21:41:40 +0000 |
---|---|---|
committer | mmichelson <mmichelson@f38db490-d61c-443f-a65b-d21fe96a405b> | 2009-02-17 21:41:40 +0000 |
commit | 8a10c42e3c67f7ce41a128d8e68b88cd724649ba (patch) | |
tree | 0d9f5260fa167a915df3e020fe135fa8016e097a /include/asterisk/frame.h | |
parent | c0c66d61ca5950434dc9c9270d44a1870bbf48ab (diff) |
Merged revisions 176697 via svnmerge from
https://origsvn.digium.com/svn/asterisk/trunk
........
r176697 | mmichelson | 2009-02-17 15:40:09 -0600 (Tue, 17 Feb 2009) | 3 lines
Clear up documentation of AST_FRIENDLY_OFFSET in frame.h
........
git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.6.1@176699 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'include/asterisk/frame.h')
-rw-r--r-- | include/asterisk/frame.h | 14 |
1 files changed, 11 insertions, 3 deletions
diff --git a/include/asterisk/frame.h b/include/asterisk/frame.h index 267a820e8..2f3c7851f 100644 --- a/include/asterisk/frame.h +++ b/include/asterisk/frame.h @@ -194,9 +194,17 @@ struct ast_frame { for this purpose instead of having to declare one on the stack */ extern struct ast_frame ast_null_frame; -#define AST_FRIENDLY_OFFSET 64 /*! It's polite for a a new frame to - have this number of bytes for additional - headers. */ +/*! \brief Offset into a frame's data buffer. + * + * 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 */ /*! Need the header be free'd? */ |