Click or drag to resize
TapiCallGenerateDigits Method
Initiates the generation of the specified digits on the call.

Namespace: Traysoft.AddTapi
Assembly: Traysoft.AddTapi (in Traysoft.AddTapi.dll) Version: 6.0.0.1110
Syntax
public void GenerateDigits(
	string digits
)

Parameters

digits
Type: SystemString
A string that contains the digits to be generated.
Exceptions
ExceptionCondition
TapiDisconnectExceptionThe call has been already disconnected.
TapiExceptionAddTapi.NET cannot generate the digits because a TAPI error occurred.
Remarks

This method generates the specified digits as inband tones using DTMF signaling. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'. In addition, the comma (,) is also a valid character. A comma injects an extra delay between the signaling of the previous and next digits it separates. The duration of this pause is hardware dependent (usually 500 ms). Multiple commas can be used to inject longer pauses. The exclamation (!) is a valid character. This character causes a "hookflash" operation (one-half second onhook, followed by one-half second offhook before continuing). The application can use GenerateDigits to perform call transfer by generating a sequence of digits that instructs the PBX to transfer a call.

Please note that GenerateDigits is an asynchronous operation. GenerateDigits queues the digits to generate and returns immediately. The telephony hardware will start digit generation after the method returns. After all digits have been generated, or after digit generation has been aborted or canceled, a Generated event is fired.

Only one inband generation request (tone generation or digit generation) is allowed to be in progress per call across all applications that are owners of the call. Digit generation on a call is canceled by initiating either another digit generation request or a tone generation request. To cancel the current digit generation, the application can call GenerateDigits and specify null (Nothing in Visual Basic for the digits parameter.

See Also