CALL_STATE enumeration (tapi3if.h)
The CALL_STATE enum is used by the ITCallInfo::get_CallState and ITCallStateEvent::get_State methods.
Syntax
typedef enum CALL_STATE {
CS_IDLE = 0,
CS_INPROGRESS,
CS_CONNECTED,
CS_DISCONNECTED,
CS_OFFERING,
CS_HOLD,
CS_QUEUED,
CS_LASTITEM = CS_QUEUED
} ;
Constants
CS_IDLEValue: 0 The call has been created, but Connect has not been called yet. A call can never transition into the idle state. This is the initial state for both incoming and outgoing calls. |
CS_INPROGRESSConnect has been called, and the service provider is working on making a connection. This state is valid only on outgoing calls. This message is optional, because a service provider may have a call transition directly to the connected state. |
CS_CONNECTEDCall has been connected to the remote end and communication can take place. |
CS_DISCONNECTEDCall has been disconnected. There are several causes for disconnection. See the table of valid call state transitions below. |
CS_OFFERINGA new call has appeared, and is being offered to an application. If the application has owner privileges on the call, it can either call Answer or Disconnect while the call is in the offering state. Current call privilege can be determined by calling ITCallInfo::get_Privilege. |
CS_HOLDThe call is in the hold state. |
CS_QUEUEDThe call is queued. |
CS_LASTITEMValue: CS_QUEUED |
Remarks
Following is a table of all valid call state transitions.
| From state | To state |
|---|---|
| CS_IDLE |
|
| CS_INPROGRESS |
|
| CS_CONNECTED |
|
| CS_DISCONNECTED | Nothing—call should be freed |
| CS_OFFERING |
|
| CS_HOLD |
|
| CS_QUEUED |
|
Requirements
| Requirement | Value |
|---|---|
| Header | tapi3if.h |