TSPI Line Device Functions
A version of this page is also available for
4/8/2010
The following table shows the TSPI line device functions with a description of the purpose of each.
| Programming element | Description |
|---|---|
Accepts the specified offered call. Optionally, this function can send the specified user-user information to the calling party. |
|
Adds the call that is specified by the hdConsultCall parameter to the conference call that is specified by the hdConfCall parameter. |
|
Answers the specified offering call. |
|
Performs a blind or single-step transfer of the specified call to the specified destination address. |
|
Closes the specified open line device after completing or aborting every outstanding call and asynchronous operation on the device. |
|
Deallocates the call after completing or aborting every outstanding asynchronous operation on the call. |
|
TSPI_lineCompleteCall |
This function is not called by TAPI. |
Completes the transfer of the specified call to the party that is connected in the consultation call. |
|
Is invoked by TAPI whenever a client application uses the LINEMAPPER value as the dwDeviceID parameter in a lineOpen function, to request that lines be scanned to find one that supports the desired media modes and call parameters. |
|
Causes the provider of the specified line device to display a modal dialog box as a child window of the hwndOwner parameter, to allow the user to configure parameters that are related to the line device. |
|
Is used as a general extension mechanism to enable service providers to provide access to features that are not described in other operations. The meanings of the extensions are device-specific, and the application must be fully aware of these extensions to take advantage of them. |
|
TSPI_lineDevSpecificFeature |
This function is not called by TAPI. |
Dials the specified dialable number on the specified call. |
|
Drops or disconnects the specified call. Optionally, user-user information can be transmitted as part of the disconnect of the call. This function can be called by the application at any time. |
|
TSPI_lineDropNoOwner |
This function is not called by TAPI. |
TSPI_lineDropOnClose |
This function is not called by TAPI. |
Forwards calls that are destined for the specified address on the specified line, according to the specified forwarding instructions. |
|
Initiates the generation of the specified digits on the specified call as inband tones by using the specified signaling mode. |
|
Generates the specified tone inband over the specified call. |
|
Queries the specified address on the specified line device to determine its telephony capabilities. |
|
Returns the address identifier that is associated with the address that is assigned to the specified line device. |
|
Queries the specified address for its current status. |
|
Retrieves the address identifier for the indicated call. |
|
Returns detailed information about the specified call. |
|
Returns the current status of the specified call. |
|
Queries a specified line device to determine its telephony capabilities. The returned information is valid for every address on the line device. |
|
Returns a data-structure object, the contents of which are specific to the line (service provider) and device class, giving the current configuration of a device that is associated one-to-one with the line device. |
|
Returns the extension identifier that the service provider supports for the indicated line device. |
|
Retrieves a service line device-specific icon to display to the user. |
|
Returns a device identifier for the specified device class that is associated with the selected line, address, or call. |
|
Queries the specified open line device for its current status. The information that is returned is global to every address on the line. |
|
Retrieves the number of address identifiers that are supported on the indicated line. |
|
Places the specified call on hold. |
|
Places a call on the specified line to the specified destination address. |
|
Enables and disables the unbuffered detection of digits that are received on the call. |
|
Enables and disables the detection of media modes on the specified call. |
|
TSPI_lineMonitorTones |
This function is not called by TAPI. |
Returns the highest extension version number for this device under which the service provider can operate, given the range of possible extension versions. |
|
Returns the highest TSPI version for this device under which the service provider can operate, given the range of possible TSPI versions. |
|
Opens the line device whose device identifier is given, and returns the handle of the service provider for the device. |
|
TSPI_linePark |
This function is not called by TAPI. |
Picks up a call alerting at the specified destination address, and returns a call handle for the picked-up call. |
|
Prepares an existing conference call for the addition of another party. |
|
Redirects the specified offering call to the specified destination address. |
|
Informs the service provider that the user-user information that is contained in the LINECALLINFO structure has been processed, and that subsequently received user-user information now can be written into that structure. |
|
Removes the specified call from the conference call to which it currently belongs. The remaining calls in the conference call are unaffected. |
|
TSPI_lineSecureCall |
This function is not called by TAPI. |
TSPI_lineSelectExtVersion |
This function is not supported in Windows Embedded CE. |
Sends user-user information to the remote party on the specified call. |
|
TSPI_lineSetAppSpecific |
This function is not called by TAPI. |
Sets certain parameters for an existing call. |
|
Is obsolete; TAPI called this function when the user (by using the Dialing Properties dialog box) or an application (by using the lineSetCurrentLocation function) changed the address translation location. |
|
Tells the service provider the new set of media modes to detect for the indicated line (replacing any previous set). |
|
Sets the configuration of the line device. |
|
TSPI_lineSetMediaControl |
This function is not called by TAPI. |
Changes the media of the call as stored in the LINECALLINFO structure of the call. |
|
Enables TAPI to specify the notification messages that the service provider should generate for events that are related to status changes for the specified line or any of its addresses. |
|
Enables TAPI to specify the terminal to which information that is related to the specified line, address, or call should be routed. |
|
Sets up a conference call for the addition of the third party. |
|
Initiates a transfer of the call specified by the hdCall function. |
|
Swaps the specified active call with the specified call on consultation hold. |
|
TSPI_lineUncompleteCall |
This function is not called by TAPI. |
Retrieves the specified held call. |
|
TSPI_lineUnpark |
This function is not called by TAPI. |