Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The following table shows the TSPI phone device functions with a description of the purpose of each.

Programming element Description

TSPI_phoneClose

Closes the specified open telephone device after completing or aborting every outstanding asynchronous operation on the device.

TSPI_phoneConfigDialog

Causes the provider of the specified telephone device to display a modal dialog box as a child window of the hwndOwnerparameter, to allow the user to configure parameters that are related to the telephone device.

TSPI_phoneDevSpecific

Is used as a general extension mechanism to enable a TAPI implementation to provide features that are not described in the other operations. The meanings of these extensions are device-specific.

TSPI_phoneGetDevCaps

Queries a specified telephone device to determine its telephony capabilities.

TSPI_phoneGetExtensionID

Retrieves the extension identifier that the service provider supports for the indicated telephone device.

TSPI_phoneGetGain

Returns the gain setting of the microphone of the hookswitch device of the specified telephone.

TSPI_phoneGetHookSwitch

Returns the current hookswitch mode of the specified open telephone device.

TSPI_phoneGetIcon

Retrieves a service telephone device-specific (or provider-specific) icon to display to the user.

TSPI_phoneGetID

Returns a device identifier for the given device class that is associated with the specified telephone device.

TSPI_phoneGetRing

Enables an application to query the specified open telephone device for its current ring mode.

TSPI_phoneGetStatus

Queries the specified open telephone device for its overall status.

TSPI_phoneGetVolume

Returns the volume setting of the hookswitch device of the specified telephone.

TSPI_phoneNegotiateExtVersion

Returns the highest extension version number under which the service provider can operate for this device, given the range of possible extension versions.

TSPI_phoneNegotiateTSPIVersion

Returns the highest TSPI version under which the service provider can operate for this device, given the range of possible TSPI versions.

TSPI_phoneOpen

Opens the telephone device whose device identifier is given, returns the opaque handle of the service provider for the device, and retains the opaque handle of TAPI for the device, for use in subsequent calls to the PHONEEVENTcallback function.

TSPI_phoneSelectExtVersion

Selects the indicated extension version for the indicated telephone device. Subsequent requests operate according to that extension version.

TSPI_phoneSetGain

Sets the gain of the microphone of the specified hookswitch device to the specified gain level.

TSPI_phoneSetHookSwitch

Sets the hook state of the hookswitch devices of the specified open telephone to the specified mode. Only the hookswitch state of the hookswitch devices that are listed is affected.

TSPI_phoneSetRing

Rings the specified open telephone device by using the specified ring mode and volume.

TSPI_phoneSetStatusMessages

Causes the service provider to filter status messages that currently are not of interest to any application.

TSPI_phoneSetVolume

Sets the volume of the speaker component of the specified hookswitch device to the specified level.