NCC.X.ADI_PLACECALL

Dependent function: nccPlaceCall

Note: All Field names in this structure are prefaced with NCC.X.ADI_PLACECALL; for example, NCC.X.ADI_PLACECALL.mediamask.

Field name

Type

Default

Units

Description

connectmask

DWORD

0x0103

mask

Determines how an outbound call gets connected. Valid values are:

  • 0x0001: Connect on out of band signal.

  • 0x0002: Connect on call progress (cp) beginning of voice.

  • 0x0004: Connect on call progress medium length voice detected.

  • 0x0008: Connect on call progress long voice.

  • 0x0010: Connect on call progress extended voice.

  • 0x0020: Connect on call progress voice end.

  • 0x0080: Connect on call progress ring stopping.

  • 0x0100: Connect on call progress CED detected.

  • 0x0200: Connect on call progress dial tone detected.

  • 0x0400: Connect on call progress SIT tone detected.

  • 0x0800: Connect on call progress ring begin.

  • 0x8000: Do not run call progress.

disconnectmask

DWORD

0x0040

mask

Determines how to abandon an outgoing call. Valid values are:

  • 0x0002: Disconnect on call progress (cp) beginning of voice.

  • 0x0004: Disconnect on call progress medium voice detected.

  • 0x0008: Disconnect on call progress long voice detected.

  • 0x0010: Disconnect on call progress extended voice detected.

  • 0x0020: Disconnect on call progress voice ended.

  • 0x0040: Disconnect on call progress timeout.

  • 0x0080: Disconnect on call progress ring tone stopped.

  • 0x0100: Disconnect on call progress CED tone detected.

  • 0x0800: Disconnect on call progress ring begin.

callprog.timeout

DWORD

1000

ms

Maximum time that can elapse with no stimulus from the network before call progress stops with a reason of timeout.

Valid range is 1 through 65535. If the value is set to zero, the timer is disabled.

callprog.busycount

DWORD

4

count

Number of non-precise busy tones that must occur before busy or fast busy is reported.

Valid range is 1 through 32767.

callprog.ringcount

DWORD

7

count

Number of ring tones that must occur before NO_ANSWER is reported.

Valid range is 1 through 32767.

callprog.maxreorder

DWORD

700

ms

Threshold time defining the total time period (on time plus off time) for distinguishing between fast busy (reorder) and slow busy.

Valid range is 0 through 32767.

callprog.maxbusy

DWORD

1500

ms

Threshold time defining the total time period (on time plus off time) for distinguishing between slow busy and ringing tone.

Valid range is 0 through 32767.

callprog.maxring

DWORD

3000

ms

Maximum duration of a tone to distinguish a ringing tone from a dial tone.

Valid range is 0 through 32767.

callprog.maxringperiod

DWORD

8000

ms

Length of time of the last ringing tone plus the silence that follows, before call progress reports a ringing-ended event.

callprog.voicemedium

DWORD

3000

ms

Minimum length of time voice must be detected before call progress reports a medium-voice event.

callprog.voicelong

DWORD

6000

ms

Minimum length of time voice must be detected before call progress reports a long-voice event.

callprog.voicextended

DWORD

9000

ms

Minimum length of time voice must be detected before call progress reports an extended-voice event.

callprog.silencetime

DWORD

1500

ms

Minimum length of a silent period after voice is detected before call progress reports a voice-ended event.

callprog.precqualtime

DWORD

150

ms

Precise tone qualification time. All precise tones must be longer than this time to qualify.

callprog.precmask

DWORD

7

mask

Mask to control which precise detectors to run. Form a value by using the OR operator with any of the following bit masks:

  • NCC_CPMSK_PRECISE_CED (0x0001): CED tone modem

  • NCC_CPMSK_PRECISE_SIT (0x0002): SIT

  • NCC_CPMSK_PRECISE_BUSY (0x0004): Busy and reorder tone (US)

  • NCC_CPMSK_PRECISE_425 (0x0008) 425 Hz tone (busy and reorder tone, non-US)

  • NCC_CPMSK_PRECISE_SITEXT (0x0010): SIT type reporting

  • NCC_CPMSK_PRECISE_TDD (0x0020): TDD/TTY device

  • NCC_CPMSK_PRECISE_NU  (0x0040): Unassigned number

Only three of the four detectors can run concurrently. If all four detectors are specified, busy and reorder tones are determined by cadence alone. The SIT, CED, and TDD/TTY detectors are enabled.

Busy and reorder tone (bit value 0x0004) and the 425 Hz tone selection (bit value 0x0008) are mutually exclusive. If you choose both, only the 425 Hz filter takes effect.

callprog.stopmask

DWORD

0

mask

Mask to control which events cause call progress to stop. A value can be formed by using the OR operation with any of the following values:

  • 0x0001: Ring tone

  • 0x0002: Ring end

  • 0x0004: Voice begin

  • 0x0008: Medium voice duration

  • 0x0010: Long voice duration

  • 0x0020: Extended voice duration

  • 0x0040: Voice end

callprog.silencelevel

INT32

-40

dBm

Maximum signal level that is considered to be silence.

Valid board range is -46 through -34.

callprog.voicetoneratio

DWORD

0x30000

IDU

Do not modify.

callprog.qualtonetime1

DWORD

60

ms

Do not modify.

callprog.qualtonetime2

DWORD

80

ms

Do not modify.

callprog.qualvoicetime1

DWORD

60

ms

Do not modify.

callprog.qualvoicetime2

DWORD

60

ms

Do not modify.

callprog.leakagetime

DWORD

8

ms

Do not modify.

callprog.noiselevel

DWORD

0x14000

IDU

Do not modify.