TSPI Phone Device Functions
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 hwndOwner parameter, 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 PHONEEVENT callback 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. |
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.