2.2.4.2.1.8 LINE_CALLSTATE
The LINE_CALLSTATE packet is sent when the status of the specified call has changed. Typically, several such packets are received during the lifetime of a call. Applications are notified of new incoming calls with this packet. A call can be established using the MakeCall packet. The application can use the GetCallStatus packet to retrieve more detailed information about the current status of the call.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
TotalSize |
|||||||||||||||||||||||||||||||
|
InitContext |
|||||||||||||||||||||||||||||||
|
fnPostProcessProcHandle |
|||||||||||||||||||||||||||||||
|
hCall |
|||||||||||||||||||||||||||||||
|
Msg |
|||||||||||||||||||||||||||||||
|
OpenContext |
|||||||||||||||||||||||||||||||
|
Param1 |
|||||||||||||||||||||||||||||||
|
Param2 |
|||||||||||||||||||||||||||||||
|
Param3 |
|||||||||||||||||||||||||||||||
|
hRemoteLine |
|||||||||||||||||||||||||||||||
TotalSize (4 bytes): An unsigned 32-bit integer. The total size of the asynchronous event packet.
InitContext (4 bytes): An unsigned 32-bit integer. The opaque, client-specified session value that MUST be equal to the InitContext value that is specified in the original scoping of the line Initialize request.
fnPostProcessProcHandle (4 bytes): An unsigned 32-bit integer. The call state–dependent information.
-
Value
Meaning
"LINECALLSTATE_BUSY"
If Param1 is LINECALLSTATE_BUSY, fnPostProcessProcHandle MUST contain details about the busy mode. This parameter MUST use one of the LINEBUSYMODE_Constants.
"LINECALLSTATE_CONNECTED"
If Param1 is LINECALLSTATE_CONNECTED, fnPostProcessProcHandle MUST contain details about the connected mode. This parameter MUST use one of the LINECONNECTEDMODE_Constants.
"LINECALLSTATE_DIALTONE"
If Param1 is LINECALLSTATE_DIALTONE, fnPostProcessProcHandle MUST contain details about the dial tone mode. This parameter MUST use one of the LINEDIALTONEMODE_Constants.
"LINECALLSTATE_OFFERING"
If Param1 is LINECALLSTATE_OFFERING, fnPostProcessProcHandle MUST contain details about the connected mode. This parameter MUST use one of the LINEOFFERINGMODE_Constants.
"LINECALLSTATE_SPECIALINFO"
If Param1 is LINECALLSTATE_SPECIALINFO, fnPostProcessProcHandle MUST contain the details about the special information mode. This parameter MUST use one of the LINESPECIALINFO_Constants.
"LINECALLSTATE_DISCONNECTED"
If Param1 is LINECALLSTATE_DISCONNECTED, fnPostProcessProcHandle MUST contain details about the disconnect mode. This parameter MUST use one of the LINEDISCONNECTMODE_Constants.
"LINECALLSTATE_CONFERENCED"
If Param1 is LINECALLSTATE_CONFERENCED, fnPostProcessProcHandle MUST contain the handle of the parent call of the conference.
-
If param1 is not any of the preceding specified values, fnPostProcessProcHandle is unused.
hCall (4 bytes): An HCALL. The handle to the call or line device that is associated with the asynchronous event.
Msg (4 bytes): An unsigned 32-bit integer. The packet type; MUST be set to 0x00000002 (LINE_CALLSTATE).
OpenContext (4 bytes): An unsigned 32-bit integer. The opaque, client-specified context value that MUST be equal to the OpenContext value that is specified in the original scoping of the line Open request.
-
This information MUST be passed back to the application with each completion and event that is associated with the handle of the line or call on the line. This field is not interpreted by TAPI.
Param1 (4 bytes): An unsigned 32-bit integer. The new call state. This parameter MUST be one of the LINECALLSTATE_Constants.
Param2 (4 bytes): An unsigned 32-bit integer. The privilege of the client on the call. The client is granted owner privilege to the call and so is set to LINECALLPRIVILEGE_OWNER.
Param3 (4 bytes): An unsigned 32-bit integer. The media type of the call. This is a combination of one or more LINEMEDIAMODE_Constants.
hRemoteLine (4 bytes): An unsigned 32-bit integer. The handle of the client for the line value.