TAPI Phone Device Functions

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

Windows Embedded CE 6.0 R3

4/8/2010

The following table shows the TAPI telephone device functions that are supported by Windows Embedded CE.

Function	Description	Category	Asynchronous?
phoneCallbackFunc	Is a placeholder for the application-supplied function name.	Callback Function	No
phoneClose	Closes the specified open telephone device.	Opening and Closing Phone Devices	No
phoneConfigDialog	Causes the provider of the specified telephone device to display a modal dialog box.	Phone Status and Capabilities	No
phoneDevSpecific	Enables a TAPI implementation to provide features that are not described in the other TAPI functions.	Extended Telephony Functions for Phone Devices	Yes
phoneGetDevCaps	Queries a specified telephone device to determine its telephony capabilities.	Phone Status and Capabilities	No
phoneGetGain	Returns the gain setting of the microphone of the hookswitch device of the specified telephone.	Hookswitch Devices	No
phoneGetHookSwitch	Returns the current hookswitch mode of the specified open telephone device.	Hookswitch Devices
phoneGetIcon	Allows an application to retrieve a service telephone device-specific (or provider-specific) icon that can be displayed to the user.	Phone Status and Capabilities	No
phoneGetID	Returns a device identifier for the specified device class that is associated with the selected phone.	Phone Status and Capabilities	No
phoneGetMessage	Returns the next TAPI application message and optionally waits for a new message.	TAPI Initialization	No
phoneGetRing	Enables an application to query the specified open telephone device for its current ring mode.	Ring	No
phoneGetStatus	Enables an application to query the specified open telephone device for its overall status.	Status	No
phoneGetStatusMessages	Indicates which status messages an application will receive.	Status	No
phoneGetVolume	Returns the volume setting of the hookswitch device of the specified telephone.	Hookswitch Devices	No
phoneInitializeEx	Initializes the use of TAPI by the application for subsequent use of the telephone abstraction.	TAPI Initialization and Shutdown	No
phoneNegotiateAPIVersion	Allows an application to negotiate an API version to use for the specified telephone device.	Phone Version Negotiation	No
phoneNegotiateExtVersion	Allows an application to negotiate an extension version to use with the specified telephone device.	Extended Telephony Functions for Phone Devices	No
phoneOpen	Opens the specified telephone device.	Opening and Closing Phone Devices	No
phoneSetGain	Sets the gain of the microphone of the specified hookswitch device to the specified gain level.	Hookswitch Devices	Yes
phoneSetHookSwitch	Sets the hook state of the hookswitch devices of the specified open telephone to the specified mode.	Hookswitch Devices	Yes
phoneSetRing	Rings the specified open telephone device by using the specified ring mode and volume.	Ring	Yes
phoneSetStatusMessages	Enables an application to monitor the specified telephone device for selected status events.	Status	No
phoneSetVolume	Sets the volume of the speaker component of the specified hookswitch device to the specified level.	Hookswitch Devices	Yes
phoneShutdown	Shuts down the usage by the application of the TAPI telephone abstraction.	TAPI Initialization and Shutdown	No