The call control connectmask and disconnectmask parameters in the NCC_X_ADI_PLACECALL_PARMS structure provide the criteria according to which the NCC API decides to connect or disconnect a successfully placed call. These criteria are protocol-specific. The NCC_X_ADI_PLACECALL_PARMS structure is passed to the NCC API when the call is placed with nccPlaceCall.
Different implementations of NCC can provide this functionality in other ways. This section describes how this functionality is provided in the ADIMGR NCC implementation.
For more information about the connectmask or disconnectmask for the protocol you are using, see your protocol-specific documentation.
The NCC_X_ADI_PLACECALL_PARMS connectmask dictates which call progress analysis event causes the NCC API to change the call state from proceeding to connected.
Each of the bits in the connectmask parameter represents a particular condition. If the bit is enabled (set) and the condition described occurs, the call is connected. When the call is connected, the NCC API generates NCCEVN_CALL_CONNECTED. The event's value field indicates the reason for the transition to the connected call state.
The NCC_X_ADI_PLACECALL_PARMS disconnectmask parameter dictates which call progress analysis events cause the NCC API to change the call state from proceeding to disconnected.
Each of the bits in the disconnectmask parameter represents a particular condition. If the bit is enabled (set) and the condition described occurs, the NCCEVN_CALL_DISCONNECTED event is generated.
The connectmask takes precedence. If a condition is selected in both the connectmask and disconnectmask, a call is connected if that condition occurs.