Dialogic Support Helpweb
Dialogic® Host Media Processing (HMP) Software
Ipm_StartMedia() Failing After Re-opening Device
Summary:Dialogic® Host Media Processing (HMP) Software function ipm_StartMedia() fails after closing and opening device.
Symptom: After successfully closing and re-opening a Dialogic HMP IP media device, a call to the ipm_StartMedia() function on that device fails and keeps failing until Dialogic HMP Software is restarted
Reason for the Problem: The most common reason for this type of failure is that a media stream that was previously opened using the ipm_StartMedia() function was not stopped before the device was closed. The sequence of relevant functions calls that would result in such a failure, are as follows:
ipm_Open() - pass ipm_StartMedia() - pass ipm_Close() - pass ipm_Open() – pass ipm_StartMedia() - FAIL
The underlying reason for this behavior is that there is presently a restriction in Dialogic HMP Software which requires an open media stream be appropriately closed, using the ipm_Stop() function, before closing the device. If this rule is not followed, the next call to ipm_StartMedia() on that channel will likely keep failing until Dialogic HMP Software is restarted. The problem will persist even if the application is closed and restarted. While it is generally recommended to stop media streams before closing devices, in all Dialogic® APIs, this restriction enforces it in Dialogic HMP Software. Fix / Solution: A simple solution is to make sure the open media stream is stopped using the ipm_Stop() function, as in the following example: ipm_Open() - pass ipm_StartMedia() – pass ipm_Stop() - pass ipm_Close() - pass ipm_Open() – pass ipm_StartMedia() - PASS Product List: Dialogic® Host Media Processing Software Release 3.0 for Windows® Glossary of Acronyms / Terms: HMP = Host Media Processing Related Documentation IP Media Library API Library Reference IP Media Library API Programming Guide
