ThbTapiCall.GenerateTone
Unit: hbTapi

The GenerateTone method the specified inband tone over the call. Invoking this function with a zero for ToneMode aborts the tone generation currently in progress on the specified call. Invoking GenerateTone or GenerateDigits or GeneratePulsedigits while tone generation is in progress aborts the current tone generation or digit generation and initiates the generation of the newly specified tone or digits.

ToneMode defines the standard tone to be generated. This value uses one of the LINETONEMODE_ constansts but not LINETONEMODE_CUSTOM:

Constant

Meaning

Value (Hex)

LINETONEMODE_CUSTOM

The tone is a custom tone defined by its component frequencies, of type LINEGENERATETONE.

00000001

LINETONEMODE_RINGBACK

The tone is ringback tone. Exact definition is service-provider defined.

00000002

LINETONEMODE_BUSY

The tone is a busy tone. Exact definition is service-provider defined.

00000004

LINETONEMODE_BEEP

The tone is a beep, such as that used to announce the beginning of a recording. Exact definition is service-provider defined.

00000008

LINETONEMODE_BILLING

The tone is a billing information tone such as a credit card prompt tone. Exact definition is service-provider defined.

00000010

Declaration

procedure GenerateTone(ToneMode, Duration: DWORD);

Remarks

Please refer to the section "lineGenerateTone" in TAPI's documentation for a more detailed information.

See Also

ThbTapiLine.OnGenerate