PHONEEVENT callback function (tspi.h)
Phone_Event a callback function implemented by TAPI and supplied to the service provider as a parameter to TSPI_phoneOpen. The service provider calls this function to report events that occur on the phone.
The PHONEEVENT type defines a pointer to this callback function. Phone_Event is a placeholder for the application-defined function name.
Syntax
PHONEEVENT Phoneevent;
void Phoneevent(
HTAPIPHONE htPhone,
DWORD dwMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2,
DWORD_PTR dwParam3
)
{...}
Parameters
htPhone
The TAPI handle for the phone on which the event occurred.
dwMsg
Specifies the kind of event that is being reported. Interpretation of the other parameters is done in different ways according to the context indicated by dwMsg.
dwParam1
A parameter for the message.
dwParam2
A parameter for the message.
dwParam3
A parameter for the message.
Return value
None
Remarks
The call state when calling this function can be any state.
The service provider passes the HTAPIPHONE value supplied to TSPI_phoneOpen as the htPhone parameter. It includes the message identifier and parameters specific to the event.
The sets of messages that can be passed to this procedure differ slightly from the messages to the corresponding callback at the TAPI level. In particular, completion of asynchronously executing requests is reported through the Completion_Proc callback instead of this one.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tspi.h |