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

220 HP-UX C SIP Stack Programmer’s Guide
Transmitter State Machine
RVSIP_TRANSMITTER_STATE_ON_HOLD
The transmitter assumes the ON_HOLD state if the
RvSipTransmitterHoldSending() function is called in the
FINAL_DEST_RESOLVED state. The application should call this function if it
wishes to manipulate the transmitter destination address and DNS list before the
message is sent. In this state, the application can use the
RvSipTransmitterSetDestAddress() function to change the current destination
address or it can supply NULL values to this function and reset the destination
address. The application can also manipulate the DNS list that contains the rest
of the DNS results. Resetting the destination address will cause the transmitter
to return to its DNS list for further address resolution.
To continue the sending activities, the application must call the
RvSipTransmitterResumeSending() function. If the transmitter has a valid
destination address, it will continue with the message sending and proceed to the
READY_FOR_SENDING state. Otherwise the transmitter will return to the
RESOLVING_ADDR state.
RVSIP_TRANSMITTER_STATE_READY_FOR_SENDING
Indicates that the transmitter is ready to send the message to the remote party.
The message in this state has its final format, and the application should no
longer change the message content or remote address. This state is informative
only.
RVSIP_TRANSMITTER_STATE_NEW_CONN_IN_USE
Indicates that the transmitter is about to use a new connection. The connection
can be a totally new connection created by the transmitter or a connection that
the transmitter found in the connection hash. In both cases the pExtraInfo will
hold a pointer to a structure of type RvSipTransmitterNewConnInUseStateInfo
that includes the connection handle.
Two reasons are associated with this state:
 RVSIP_TRANSMITTER_REASON_NEW_CONN_CREATED
—indicates that the transmitter created a new connection.
 RVSIP_TRANSMITTER_REASON_CONN_FOUND_IN_
HASH—indicates that the transmitter found an existing
connection in the connection hash and that the transmitter is
about to use the connection.