User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 217
Dialogic Corporation
ipm_ModifyMedia( )
modify properties of active media session
 Description
The ipm_ModifyMedia( ) function modifies various properties of an active media session. This
function allows the application to modify the following media session properties:
• direction of the media stream
• IP address and port
• coder properties
For this function to complete successfully, the stream associated with the IP device must be in
either active or suspended mode.
The media session properties are changed on the local endpoint as soon the function is called, and
this may result in a perceptible artifact (for example, a click or a brief silence) until the remote
endpoint makes the corresponding change. For example, if the coder is being changed by the
function call, the local endpoint begins transmitting packets using the new coder and stops
accepting packets that it receives which use the old coder as soon as the function executes.
Name: int ipm_ModifyMedia(nDeviceHandle, *pMediaInfo, eDirection, usMode)
Inputs: int nDeviceHandle
• IP Media device handle
IPM_MEDIA_INFO *pMediaInfo
• pointer to media information structure
eIPM_DATA_DIRECTION eDirection
• data flow direction
unsigned short usMode
• async or sync mode setting
Returns: 0 on success
-1 on failure
Includes: srllib.h
ipmlib.h
Category: Media Session
Mode: asynchronous or synchronous
Parameter Description
nDeviceHandle handle of the IP Media device
pMediaInfo pointer to structure that contains local channel RTP/RTCP ports and IP
address information (or T.38 port and IP address information)
See the IPM_MEDIA_INFO data structure page for details.