2.2.4.2.1.29 PHONE_DEVSPECIFIC

The PHONE_DEVSPECIFIC packet is sent to notify the application about device-specific events that occur on a phone, address, or call. The meaning of the event and the interpretation of the fields are device-specific.


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

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 phone 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 phone device that is associated with the asynchronous event.

Msg (4 bytes): An unsigned 32-bit integer. The packet type; MUST be set to 0x00000010 (PHONE_DEVSPECIFIC).

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 phone Open request.

This information MUST be passed back to the application with each completion and event that is associated with the handle of the phone. This field is not interpreted by TAPI.

Param1 (4 bytes): An unsigned 32-bit integer. Device specific.

Param2 (4 bytes): An unsigned 32-bit integer. Device specific.

Param3 (4 bytes): An unsigned 32-bit integer. Device specific.

Param4 (4 bytes): An unsigned 32-bit integer. If the event is specific to a call, this field MUST contain the remote handle to the phone device. Otherwise, this field is set to 0.

If a valid call handle is associated with the packet, the server MUST set the hDevice field to the hCall value and the Param4 field to the hRemotePhone value.

If no valid call handle is associated with the packet, the server MUST set the hDevice field to the hRemotePhone value and the Param4 field to 0.