Intel 05-1832-002 User Manual

Voice API for Windows Operating Systems Library Reference — November 2003

451

make a full or half-duplex connection — nr_scroute( )

nr_scroute( )

make a full or half-duplex connection

! Description

The nr_scroute( ) convenience function makes a full or half-duplex connection between two
devices connected to the time division multiplexing (TDM) bus.

This convenience function is not a part of any library and is provided in a separate C source file
called sctools.c in the \dialogic\sctools directory.

The nr_sc prefix to the function signifies network (analog and digital) devices and resource (voice,
and fax) devices accessible via the TDM bus.

Note:

Digital Network Interface (DTI), Modular Station Interface (MSI), and fax functionality may be
conditionally compiled in or out of the function using the DTISC, MSISC, and FAXSC defines in
the makefile provided with the function. For example, to compile in DTI functionality, link with the
DTI library. To compile in fax functionality, link with the fax library. Error message printing may
also be conditionally compiled in or out by using the PRINTON define in the makefile.

Name:

int nr_scroute(devh1, devtype1, devh2, devtype2, mode)

Inputs:

int devh1

•

valid channel device handle

unsigned short devtype1

•

type of device for devh1

int devh2

•

valid channel device handle

unsigned short devtype2

•

type of device for devh2

unsigned char mode

•

half or full duplex connection

Returns:

0 on success
-1 on error

Includes:

stdio.h
varargs.h
srllib.h
dxxxlib.h
dtilib.h (optional)
msilib.h (optional)
faxlib.h (optional)
sctools.h

Category:

TDM Routing

Mode:

synchronous

Platform:

DM3, Springware