Table of Contents Index NMS Glossary Previous Page Next Page (Page 9 of 11 in this chapter) Version

trauSendMsg

Description

Sends a routine to a specific AG TRAU program.

Prototype

DWORD trauSendMsg ( CTAHD ctahd,
unsigned msg_id,
WORD *msg_parms,
unsigned num_parms )

ctahd CTA context handle used with trauAttach to attach an AG TRAU channel.

msg_id Program-specific message identifier.

msg_parms Pointer to an array of 16-bit parameters passed with the message. If there are no parameters to pass, set to NULL.

num_parms Number of elements in the array referenced by msg_parms. If no parameters are passed, set this to zero.

Return Values

Events

A response event is generated based on the specific routine and the type of AG TRAU program. Events generated by trauSendMsg routines supply the AG TRAU channel's ctahd in the CTA_EVENT.ctahd field.

Note: Because an event is expected in response to a message, do not send another message until the response event is received.

Details

This function sends a command to a specified AG TRAU channel. These routines are built from the msg_id and the associated msg_parms array, and are specific to the type of AG TRAU on which the channel runs.

Supported msgids include:
msg_id

 Description

TRAUCMD_NOTCH_CTRL

 Enables and disables frequency suppression filters.

TRAUCMD_SETVAD

 Enables and disables voice activity detection (VAD).

TRAUCMD_ECHOCNTL

 Enables, disables and controls echo cancellation.

TRAUCMD_SETGAIN

 Sets vocoder input and output gain.

TRAUCMD_CHNG_DEC

 Changes the coding format in the IP packet from
mu-Law to A-law (G.711 only).

Note: Depending on the type of routine specified with trauSendMsg, the AG TRAU service may or may not return a buffer with additional data.

Each trauSendMsg routine is valid for specific types of AG TRAU programs. For more information about trauSendMsg msgids and values, refer to Appendix C.

See Also

trauRegisterCallback, trauReleaseBuffer


Table of Contents Index NMS Glossary Previous Page Next Page (Page 9 of 11 in this chapter) Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.