Dialogic Dialogic Global Call IP IP Phone User Manual


 
}
}
.
.
.
return 0;
}
4.10.4 Sending MIME Information
Table 13 lists the Global Call functions that can be used to send SIP messages with MIME
information using the IPSET_MIME parameter set ID in the attached GC_PARM_BLK. Except in
the cases of and , sending a SIP message with MIME requires
two function calls, to set the information, and a second function to cause the
library to send the message.
If the application only needs to send a single MIME part but the call control library also needs to
send SDP information, the firmware automatically and transparently constructs the required
multipart MIME message.
If the application needs to send multipart MIME, all the MIME information is set collectively
within one function call on the given device by inserting multiple IPPARM_MIME_PART
parameters in the desired order to construct a multipart MIME body. The MIME information set by
current function always overwrites any MIME information set by previous functions, so that an
application set multiple MIME parts by calling multiple times.
The parameter set ID IPSET_MIME_200OK_TO_BYE is used for a special case of MIME
message. Unlike other outgoing SIP messages that are sent explicitly by Global Call functions, the
200 OK to BYE message is sent automatically when a BYE is received. In order to attach MIME
information to a 200 OK to BYE message, the MIME information has to be pre-loaded by
with set ID IPSET_MIME_200OK_TO_BYE on a channel before the
GCEV_DISCONNECTED event (SIP BYE message) is received. If a MIME message with
IPSET_MIME_200OK_TO_BYE parameters is not set before the GCEV_DISCONNECTED
event (BYE) is received, the automatic 200 OK message will be sent without any MIME body.
Note that the parameter set ID must be set to IPSET_MIME_200OK_TO_BYE in
GC_PARM_BLK associated with the message, not just the top-level block. MIME information set
Table 13. Global Call Functions for SIP MIME Messages Using IPSET_MIME
Global Call Function to Set
MIME Parameter Block
Global Call Function to
Send MIME Message
Device
Type
Outgoing SIP Message with
MIME
gc_MakeCall( )
gc_Extension( )
gc_SetUserInfo( ) gc_CallAck( )
gc_SetUserInfo( ) gc_AcceptCall( )
gc_SetUserInfo( ) gc_AnswerCall( )
gc_SetUserInfo( ) gc_DropCall( )