Extended Services - Toshiba Strata DK40 Installation & Maintenance Manual

Computer Telephony Integration

Extended Services

lineNegotiateExtVersion
The following two extended services are available when an application negotiates for a
revision level 1 extended service.
Snapshot Data Structure (Application)
The snapshot data structure is provided for applications that want to provide an image of the
DKT 2000 phone within the PC Application Program along with their TAPI interface. The
Toshiba Service Provider will send a message each time an update occurs in the LED or LCD
display that looks like a snapshot of the phone which can be used to provide the identical
display in the PC as seen on the phone. The following chart is a description of the meaning of
the ongoing displays when calls are being handled by the Strata DK. For example, an
incoming call will cause a series of messages to change the LED flash rate each second to
either 10Hz or OFF until the call is answered.
The LCD and LED events are available to applications who negotiate with the service
provider for extension version 1.0 (lineNegotiateExtVersion). After successfully negotiating
this version, the service provider will send the LINE_LINEDEVSTATE notification message
with the dwParam1 set to LINEDEVSTATE_DEVSPECIFIC each time the information
changes. To retrieve this snapshot view of the DKT's current LED/LCD state, call
lineGetLineDevStatus. The service provider will fill in the dwDevSpecific section of
LINEDEVSTATUS structure with a DKTSNAPSHOT structure. This structure is defined as
follows:
#pragma pack (1)
#define MAX_KEYS 20
#define DISPLAY 16
enum EledFlashRate
enumELed Colour
enum EkeyType
typedef struct_tagFLEXKEY {
EledFlashRate eFlashRate;
ELedColour eColour;
8-26
Refer to the Strata DK40 Programming Manual or DK Library CD-Rom for more details.
{EFlashON = 1, EFlash1Hz, EFlash2Hz,
EFlash10Hz, EFlashIUse, EFlash4Hz, EFlashOff};
{ERed = 0, EGreen};
(INVALIDKEY = 0, ECO_Line, EDND,
EFeature_Key, EFlash, EHot_Line, EIntercom,
EMessage_Waiting, EMultiLine_Hunt,
EPrime_Line, EPrivate_Line, ERelease,
ESecondary_Appearance,
ESecondary_Private_Line, ESpeed_Dial,
ESpeed_Dial_Pause, EData, EData_Release};
//Current LED Flash Rate
//Current LED Colour
//Key Type
Strata DK40 I&M Manual Spring 1999
Extended Services