PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Limitation
  • WLanguage procedure
  • Required configuration
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
tapiListen (Function)
In French: telDémarreDétectionAppel
Starts the call detection (also called "call monitoring service").
WINDEV Note: By default, the device used is the first TAPI 2-compatible device found. A specific device can be selected by tapiDevice. In this case, this specific device will be used.
// Starts the service for call detection
IF tapiListen("IncomingCall", tapiOptionMediaModeFax, "CallDetection") = True THEN
// The service for call detection is started
Message("Call detection enabled")
ELSE
// The service for call detection is not started
Error("Unable to start the call detection" + CR + ...
"Error details:"+ CR + ErrorInfo(errMessage))
END
Syntax
<Result> = tapiListen(<Service Identifier> [, <Options>] , <Procedure Name> , <Custom Parameter>)
<Result>: Boolean
  • True if the call detection is enabled,
  • False otherwise.
<Service Identifier>: Character string (with quotes)
Name used to identify the service for call detection.
<Options>: Optional constant
Characteristics of call detection:
tapiOptionDefault
(default option)
Detecting calls on a fax modem. In most cases, the functions for handling calls are not supported by the modems.
This option cannot be used with the other options.
tapiOptionMonitorDetects the calls (to perform statistics for example), even if they are managed by an application. No operation will be possible on the call.
tapiOptionMediaModeVoiceDetects the voice calls.
Note: The Fax modems that allow auto-dialing may return this constant. In this case, a WLanguage error will occur.
tapiOptionMediaModeUnknownDetects the unknown types of calls.
tapiOptionMediaModeFaxDetects the calls coming from a fax.
<Procedure Name>: Character string (with or without quotes)
Name of WLanguage procedure called during a call detection or when the call status changes. This procedure has the following format:
PROCEDURE <Procedure Name> (<Service Identifier>, <Call Identifier>,
<Call Status>, <Parameter>)
  • <Service Identifier>: identifier of service that detected the call
  • <Call Identifier>: integer identifying the call. Can be used in all the functions for handling the call.
  • <Call Status>: integer that can take the following values:
    tapiLineBusyThe line is currently busy.
    tapiLineConnectedThe line is connected.
    tapiLineDialingDialing in progress.
    tapiLineDialToneThe line gets a dial tone.
    tapiLineDisconnectedThe correspondent has hung up.
    tapiLineProceedingThe call is dialed: searching for the correspondent.
    tapiLineRingBackRinging in progress.
    tapiNewCallNew call detected waiting for an answer or for a reject.
    tapiCallInformationThe additional information (presentation of the number) is available. In most cases, this information will be available after the fist ring.
    tapiMonitoredDigitA phone key has been used. To find out the list of keys used, call tapiKeyPressed.
  • <Parameter> is the custom parameter passed to tapiListen.
Caution: this procedure must contain no call to the debugger (no breakpoint, no STOP keyword, no auto-stop expression, ...).
<Custom Parameter>: Any type
Parameter passed to the WLanguage procedure.
Remarks

Limitation

tapiListen cannot be called in the procedure for call detection.

WLanguage procedure

The WLanguage procedure is run in a WLanguage thread.
Caution: The following processes cannot be run in the threads:
See Managing threads for more details.
WINDEVUser code (UMC)

Required configuration

The telephony functions are using the TAPI 2.0 technology. This technology can be used on all the systems.
However, if the system used is Windows NT4, the service pack 4 (or later) must be installed.
Note: The TAPI 3.0 technology (and later) is not supported in this version.
Components
WINDEVReports and Queries wd230com.dll
Windows Mobile wp230com.dll
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment