2.2.4.2.1.11 LINE_CREATEDIALOGINSTANCE

The LINE_CREATEDIALOGINSTANCE packet causes TAPI to create an association between the service provider and the application that invoked the asynchronous Telephony Service Provider Interface (TSPI) function that generated this asynchronous event.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

TotalSize

InitContext

fnPostProcessProcHandle

hDevice

Msg

OpenContext

Param1

Param2

Param3

Param4

VarData (variable)

...

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. MUST be set to zero when sent and MUST be ignored on receipt.

hDevice (4 bytes): An unsigned 32-bit integer. 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 0x000001F7 (LINE_CREATEDIALOGINSTANCE).

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 size, in bytes, of the ASYNCEVENTMSG packet (40).

Param2 (4 bytes): An unsigned 32-bit integer. The size, in bytes, of the VarData field.

Param3 (4 bytes): An unsigned 32-bit integer. The offset, in bytes, of the VarData field.

Param4 (4 bytes): An unsigned 32-bit integer. This MUST be ignored on receipt and can be any value. 

VarData (variable): A string of UNICODE characters, which can be null terminated.