Plays an application-provided RFC 2833 DTMF event onto the IP network in RTP encapsulation. For more information, refer to Transferring DTMF digits according to RFC 2833.
DWORD h324PassthruPlayRFC2833 ( MSPHD msphd, WORD event, WORD duration)
|
Argument |
Description |
|
msphd |
MSPP handle associated with the MUX endpoint. |
|
event |
RFC 2833 event (0 - 255) to send. Refer to the RFC 2833 specification for information about available options. |
|
duration |
Duration of the RFC2833 event, in ms. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_NOT_FOUND |
msphd does not map to a current audio pass-through channel. Either h324Start was not called, h324Stop was called, or the wrong handle was passed by the application. |
|
H324ERR_INTERNAL_ERROR |
Internal error in the 3G-324M Middleware. |
|
H324ERR_MUTEX_LOCK_FAILED |
Internal error trying to lock mutex. |
|
H324ERR_NOT_INITIALIZED |
h324Initialize was not called first. |
|
Event |
Description |
|
H324EVN_PASSTHRU_PLAY_RFC2833_DONE |
MSPP service accepted the command to send the specified DTMF digit in RFC 2833 encapsulation, and forwards the command to the runtime software on the CG board. |
{
DWORD result;
WORD nEventID, nEventDuration;
nEventID = ‘3’; // The keypad digit ‘3’
EventDuration = 80; // Digit pressed for 80 ms.
result = h324PassthruPlayRFC2833(GwConfig[0].MuxEp.hd, nEventID, EventDuration);
if (result != SUCCESS)
printf("ERROR: h324PassthruPlayRFC2833() failed.\n");
}