HP-UX C SIP Stack Programmer's Guide (Novembery 2007)

328 HP-UX C SIP Stack Programmer’s Guide
Transport Layer Raw Buffer and Message Monitoring
RvSipTransportBufferReceivedEv()
Just before parsing an incoming SIP message the SIP Stack gives the application
the chance to look at the message raw buffer. The callback supplies a buffer with
exactly one textual SIP message, the local and remote addresses of the message,
and the connection handle if TCP was used. Based on the callback information,
the application can instruct the SIP Stack to discard the buffer using an OUT
parameter.
Note When TCP is used the buffer can be a result of several accumulated
packets.
RvSipTransportMsgReceivedExtEv()
Notifies the application that a new SIP message was received and parced, but
not yet processed.
RvSipTransportConnectionDataReceivedEv
Notifies the application that data was received on a connection. The data may
not be a full message since a SIP message can arrive in multiple packets on
TCP.
RvSipTransportConnectionParserResultEv()
The SIP Stack allows an application to control the quality of the connection in
terms of successfully parsed messages. For each received buffer containing one
SIP message, the SIP Stack reports the result of the buffer parsing to the
application through this callback. The connection handle is provided with the
callback. If the application decides about an unacceptable level of errors in
messages that are received on the connection, it can terminate the connection
using the Connection API.