Global Call API for HMP on Windows Programming Guide — August 2006 71
4
4.Event Handling
This chapter describes how Global Call handles events generated in the call state model. Topics
include:
•Overview of Event Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
•Event Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
•Blocked and Unblocked Event Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
•Event Retrieval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
•Events Indicating Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
•Masking Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
•Event Handlers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
4.1 Overview of Event Handling
The Global Call protocol handler continuously monitors the line device for events from the
network. As each call is processed through its various states, corresponding events are generated
and passed to the application. An overview of Global Call event categories is provided in this
chapter. Specific event definitions are described in the Global Call API Library Reference. See the
appropriate Global Call Technology Guide for technology-specific event information.
4.2 Event Categories
The events that can occur when using the Global Call API are divided into the following categories:
Termination
Events returned after the termination of a function. Termination events apply to asynchronous
programming only.
Notification
Events that are requested by the application and provide information about a function call.
Notification events apply to synchronous and asynchronous programming.
Unsolicited
Events triggered by, and providing more information about, external events. Unsolicited events
apply to synchronous and asynchronous programming.
See the Global Call API Library Reference for detailed information about each event and the
appropriate Global Call Technology Guide for any technology-specific event information.