Informs the MGCP service that a particular event condition has occurred.

DWORD mgcReportEvent (CTAHD ctahd,
char *epname,
char *event)

ctahd Context handle associated with the gateway application.

epname Pointer to an endpoint name associated with a registered MGCP endpoint. This name cannot include wild cards.

event Name of the returned event. The name of the event must be specified in the form package/event unless it is an event in the endpoint's default package. If the event is in the endpoint's default package, the event can be specified in the form event.

• SUCCESS
• CTAERR_INVALID_STATE
  The MGCP service cannot report the event because the endpoint has been unregistered.
• MGCERR_BAD_ENDPOINT
  The specified endpoint is not registered with the MGCP service.
• MGCERR_BAD_EVENT
  The event does not exist or does not apply to the specified MGCP endpoint.
• MGCERR_INVALID_STATE
  Wrong signal or event processing state, or invalid function argument.
• MGCERR_NOT_GW_HANDLE
  The specified ctahd is not the handle associated with the application.
• MGCERR_REPORT_EVENT_UNDETECTED
  The application has reported an event that it should not be detecting.

None.

Applications use mgcReportEvent to inform the MGCP service that an event condition has been detected.

If the event is associated with additional data, use parenthesis to specify the data. For example, to indicate that the application has detected an adsi event (returned by the handset extension package) associated with a no caller id display string, the application would specify the following event argument:

H/adsi(no caller id)

char   PkgEvt[80]; // package and event
char   epName[20]; // endpoint name

strcpy(epName,"DS001");
strcpy(PkgEvt,"x-Foobar/a3");

ret = mgcReportEvent(GWctahd, epName, PkgEvt);
// GWctahd = CTA Handle returned from ctaCreateContext
// for the application
if (ret != SUCCESS)
{
 printf("mgcReportEvent returned error 0x%x\n", ret);
 return FAILURE;
}

mgcDefinePackage, mgcEventDone, mgcEventProcessed