Partager via


TAPI Phone Device Functions

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