This structure contains call data. This data remains fixed during the call and is obtained with the lineGetCallInfo function. If a part of the structure does change, then a LINE_CALLINFO message is sent to the application indicating which data item has changed. Dynamically changing call data, such as call progress status, is available in the LINECALLSTATUS structure, returned with the lineGetCallStatus function.
At a Glance
Header file: | Tapi.h |
Windows CE versions: | 1.0 and later |
Syntax
typedef struct linecallinfo_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
HLINE hLine;
DWORD dwLineDeviceID;
DWORD dwAddressID;
DWORD dwBearerMode;
DWORD dwRate;
DWORD dwMediaMode;
DWORD dwAppSpecific;
DWORD dwCallID;
DWORD dwRelatedCallID;
DWORD dwCallParamFlags;
DWORD dwCallStates;
DWORD dwMonitorDigitModes;
DWORD dwMonitorMediaModes;
LINEDIALPARAMS DialParams;
DWORD dwOrigin;
DWORD dwReason;
DWORD dwCompletionID;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwCountryCode;
DWORD dwTrunk;
DWORD dwCallerIDFlags;
DWORD dwCallerIDSize;
DWORD dwCallerIDOffset;
DWORD dwCallerIDNameSize;
DWORD dwCallerIDNameOffset;
DWORD dwCalledIDFlags;
DWORD dwCalledIDSize;
DWORD dwCalledIDOffset;
DWORD dwCalledIDNameSize;
DWORD dwCalledIDNameOffset;
DWORD dwConnectedIDFlags;
DWORD dwConnectedIDSize;
DWORD dwConnectedIDOffset;
DWORD dwConnectedIDNameSize;
DWORD dwConnectedIDNameOffset;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectionIDSize;
DWORD dwRedirectionIDOffset;
DWORD dwRedirectionIDNameSize;
DWORD dwRedirectionIDNameOffset;
DWORD dwRedirectingIDFlags;
DWORD dwRedirectingIDSize;
DWORD dwRedirectingIDOffset;
DWORD dwRedirectingIDNameSize;
DWORD dwRedirectingIDNameOffset;
DWORD dwAppNameSize;
DWORD dwAppNameOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwChargingInfoSize;
DWORD dwChargingInfoOffset;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
} LINECALLINFO, FAR *LPLINECALLINFO;
Members
dwTotalSize
Specifies the total size, in bytes, allocated to this data structure.
dwNeededSize
Specifies the size, in bytes, for this data structure needed to contain all the returned data.
dwUsedSize
Specifies the size, in bytes, of the portion of this data structure that contains useful data.
hLine
Handle for the line device with which this call is associated.
dwLineDeviceID
Specifies the device identifier of the line device with which this call is associated.
dwAddressID
Specifies the address identifier of the address on the line on which this call exists.
dwBearerMode
Specifies the current bearer mode of the call. It uses the following LINEBEARERMODE_ constants:
Value | Description |
LINEBEARERMODE_VOICE | A regular 3.1 kHz analog voice grade bearer service. Bit integrity is not assured. Voice can support fax and modem media modes. |
LINEBEARERMODE_SPEECH | Corresponds to the G.711 codec speech transmission on the call. The network can use processing techniques such as analog transmission, echo cancellation, and compression/decompression. Bit integrity is not assured. Speech is not intended to support fax and modem media modes. |
LINEBEARERMODE_MULTIUSE | The multiuse mode, defined by ISDN. |
LINEBEARERMODE_DATA | The unrestricted data transfer on the call. The data rate is specified separately. |
LINEBEARERMODE_ALTSPEECHDATA | The alternate transfer of speech or unrestricted data on the same call; ISDN. |
LINEBEARERMODE_NONCALLSIGNALING | A non-call-associated signaling connection from the application to the service provider or switch; treated as a media stream by TAPI. |
LINEBEARERMODE_PASSTHROUGH | When a call is active in LINEBEARERMODE_PASSTHROUGH, the service provider gives direct access to the attached hardware for control by the application. This mode is used primarily by applications desiring temporary direct control over asynchronous modems, accessed through the Win32 communication functions, for the purpose of configuring or using special features not otherwise supported by the service provider. |
dwRate
Specifies the rate of the call data stream, in bits per second (bps).
dwMediaMode
Specifies the media mode of the data stream currently on the call. This is the media mode determined by the owner of the call, which is not necessarily the same as that of the last LINE_MONITORMEDIA message. This member is not directly affected by the LINE_MONITORMEDIA messages. It uses the following LINEMEDIAMODE_ constants:
Value | Description |
LINEMEDIAMODE_UNKNOWN | A media stream exists, but its mode is not known. This corresponds to a call with an unclassified media type. In typical analog telephony environments, an incoming call’s media mode may be unknown until after the call has been answered and the media stream has been filtered to make a determination. |
LINEMEDIAMODE_INTERACTIVEVOICE | Speech is detected on the call and the call is treated as an interactive call with a humans at each end. |
LINEMEDIAMODE_AUTOMATEDVOICE | Speech is detected on the call and is handled locally by an application. |
LINEMEDIAMODE_DATAMODEM | A data modem session is detected on the call. |
LINEMEDIAMODE_G3FAX | A group 3 fax is being sent or received on the call. |
LINEMEDIAMODE_G4FAX | A group 4 fax is being sent or received on the call. |
LINEMEDIAMODE_TDD | A TDD (Telecommunications device for the deaf) session on the call. |
LINEMEDIAMODE_DIGITALDATA | Digital data being sent or received on the call. |
LINEMEDIAMODE_TELETEX | A teletext session on the call. Teletext is one of the telematic services. |
LINEMEDIAMODE_VIDEOTEX | A videotext session on the call. Videotext is one of the telematic services. |
LINEMEDIAMODE_TELEX | A telex session on the call. Telex is one of the telematic services. |
LINEMEDIAMODE_MIXED | A mixed session on the call. Mixed is one of the ISDN telematic services. |
LINEMEDIAMODE_ADSI | An ADSI (Analog Display Services Interface) session on the call. |
LINEMEDIAMODE_VOICEVIEW | The media mode of the call is VoiceView. |
dwAppSpecific
Uninterpreted by the API implementation and service provider. It can be set by any owner application of this call with the lineSetAppSpecific function.
dwCallID
In some telephony environments, the switch, or service provider can assign a unique identifier to each call. This enables the call to be tracked across transfers, forwards, or other events. The domain of these call identifiers and their scope is service provider-defined. The dwCallID member makes this unique identifier available to the applications.
dwRelatedCallID
Telephony environments that use the call identifier often may find it necessary to relate one call to another. The dwRelatedCallID member can be used by the service provider for this purpose.
dwCallParamFlags
Specifies a collection of call-related parameters when the call is outgoing. These are the same call parameters specified in lineMakeCall, of type LINECALLPARAMFLAGS_. It is one of the following values:
Value | Description |
LINECALLPARAMFLAGS_SECURE | The call is currently secure. This flag is also updated if the call is later secured with the lineSecureCall function. |
LINECALLPARAMFLAGS_IDLE | The call started out using an idle call. |
LINECALLPARAMFLAGS_BLOCKID | The originator identity was concealed (block caller IDpresentation to the remote party). |
LINECALLPARAMFLAGS_ORIGOFFHOOK | The originator’s phone was automatically disconnected. |
LINECALLPARAMFLAGS_DESTOFFHOOK | The called party’s phone was automatically disconnected. |
dwCallStates
Specifies the call states of type LINECALLSTATE_ for which the application can be notified on this call. The dwCallStates member is constant in LINECALLINFO and does not change depending on the call state. It is one of the following values:
Value | Description |
LINECALLSTATE_IDLE | The call is idle—no call exists. |
LINECALLSTATE_OFFERING | The call is offered to the station signaling the arrival of a new call. In some environments, a call in the offering state does not automatically alert the user; the alert is handled by the switch instructing the line to ring. It does not affect any call states. |
LINECALLSTATE_ACCEPTED | The call was offered and accepted. This indicates to monitoring applications that the current owner application has claimed responsibility for answering the call. In ISDN, this also initiates alerting to both parties. |
LINECALLSTATE_DIALTONE | The call is receiving a dial tone from the switch, which means that the switch is ready to receive a dialed number. |
LINECALLSTATE_DIALING | Destination address data, a phone number, is being sent to the switch on the call. The lineGenerateDigits function does not place the line into the dialing state. |
LINECALLSTATE_RINGBACK | The call is receiving a ringback from the called address. Ringback indicates that the other station has been reached and is being alerted. |
LINECALLSTATE_BUSY | The call is receiving a busy signal. A busy signal indicates that the call cannot be completed—either a circuit (trunk) or the remote party station are in use. |
LINECALLSTATE_SPECIALINFO | Special data is sent by the network. Special data is typically sent when the destination cannot be reached. |
LINECALLSTATE_CONNECTED | The call has been established, the connection is made. Data is able to flow on the call between the originating address and the destination address. |
LINECALLSTATE_PROCEEDING | Dialing has completed and the call is proceeding through the switch or telephone network. |
LINECALLSTATE_ONHOLD | The call is on hold by the switch. |
LINECALLSTATE_CONFERENCED | The call is currently a member of a multiparty conference call. |
LINECALLSTATE_ONHOLDPENDCONF | The call is currently on hold while being added to a conference. |
LINECALLSTATE_ONHOLDPENDTRANSF | The call is currently on hold waiting transfer to another number. |
LINECALLSTATE_DISCONNECTED | The remote party has disconnected from the call. |
LINECALLSTATE_UNKNOWN | The call state is not known. This may be due to limitations of the call progress detection implementation. |
dwMonitorDigitModes
Specifies the various digit modes of type LINEDIGITMODE_ for which monitoring is currently enabled. It is one of the following values:
Value | Description |
LINEDIGITMODE_PULSE | Uses pulse or rotary for digit signaling. |
LINEDIGITMODE_DTMF | Uses DTMF tones for digit signaling. |
LINEDIGITMODE_DTMFEND | Uses DTMF tones for digit detection, and also detects the down edges. |
dwMonitorMediaModes
Specifies the various media modes for which monitoring is currently enabled, of type LINEMEDIAMODE_. It is one of the following values:
Value | Description |
LINEMEDIAMODE_INTERACTIVEVOICE | The presence of speech on the call and the call is treated as an interactive call with a human on both ends. |
LINEMEDIAMODE_AUTOMATEDVOICE | The presence of speech on the call and the voice is locally handled by an automated application. |
LINEMEDIAMODE_DATAMODEM | A data modem session on the call. |
LINEMEDIAMODE_G3FAX | A group 3 fax is being sent or received on the call. |
LINEMEDIAMODE_G4FAX | A group 4 fax is being sent or received on the call. |
LINEMEDIAMODE_TDD | A TDD (Telecommunications device for the deaf) session on the call. |
LINEMEDIAMODE_DIGITALDATA | Digital data is being sent or received on the call. |
LINEMEDIAMODE_TELETEX | A teletext session on the call. Teletext is one of the telematic services. |
LINEMEDIAMODE_VIDEOTEX | A videotext session on the call. Videotext is one of the telematic services. |
LINEMEDIAMODE_TELEX | A telex session on the call. Telex is one of the telematic services. |
LINEMEDIAMODE_MIXED | A mixed session on the call. Mixed is one of the ISDN telematic services. |
LINEMEDIAMODE_ADSI | An ADSI (Analog Display Services Interface) session on the call. |
LINEMEDIAMODE_VOICEVIEW | The media mode of the call is VoiceView. |
DialParams
The dialing parameters currently in effect on the call, of type LINEDIALPARAMS. Unless these parameters are set by either lineMakeCall or lineSetCallParams, their values are the same as the defaults used in the LINEDEVCAPS structure.
dwOrigin
Identifies where the call originated from. It uses the following LINECALLORIGIN_ constants:
Value | Description |
LINECALLORIGIN_OUTBOUND | The call is outgoing. |
LINECALLORIGIN_INTERNAL | The call is incoming and originated internally. |
LINECALLORIGIN_EXTERNAL | The call is incoming and originated externally. |
LINECALLORIGIN_UNKNOWN | The call is an incoming call and its origin is currently unknown, but may be identified later. |
LINECALLORIGIN_UNAVAIL | The call is an incoming call. Its origin is not available and will never be identified. |
LINECALLORIGIN_CONFERENCE | The call handle is for a conference call, that is, the application’s connection to the conference bridge in the switch. |
dwReason
Specifies the reason why the call occurred. It uses the following LINECALLREASON_ constants:
Value | Description |
LINECALLREASON_DIRECT | The call is a direct call. |
LINECALLREASON_FWDBUSY | The call was forwarded from another extension that was busy at the time of the call. |
LINECALLREASON_FWDNOANSWER | The call was forwarded from another extension that did not answer the call after some number of rings. |
LINECALLREASON_FWDUNCOND | The call was forwarded unconditionally from another number. |
LINECALLREASON_PICKUP | The call was picked up from another extension. |
LINECALLREASON_UNPARK | The call was retrieved as a parked call. |
LINECALLREASON_REDIRECT | The call was redirected to this station. |
LINECALLREASON_CALLCOMPLETION | The call was the result of a call completion request. |
LINECALLREASON_TRANSFER | The call has been transferred from another number. Party identifier data may identify the caller and where the call was transferred from. |
LINECALLREASON_REMINDER | The call is a reminder that the user has a call parked or on hold for a potentially long time. |
LINECALLREASON_UNKNOWN | The reason for the call is currently unknown, but may be identified later. |
LINECALLREASON_UNAVAIL | The reason for the call is unavailable and cannot be identified later. |
dwCompletionID
Specifies the completion identifier for the incoming call if it is the result of a completion request that terminates. This identifier is meaningful only if dwReason is LINECALLREASON_CALLCOMPLETION.
dwNumOwners
Specifies the number of application modules with different call handles with owner privilege for the call.
dwNumMonitors
Specifies the number of application modules with different call handles with monitor privilege for the call.
dwCountryCode
Specifies the country code of the destination party. Zero if unknown.
dwTrunk
Specifies the number of the trunk over which the call is routed. This member is used for both incoming and outgoing calls. The dwTrunk member should be set to 0xFFFFFFFF if it is unknown.
dwCallerIDFlags
Determines the validity and content of the caller party identifier data. The caller is the originator of the call. It uses the following LINECALLPARTYID_* constants:
Value | Description |
LINECALLPARTYID_BLOCKED | Caller identifier data for the call has been blocked by the caller, but would otherwise have been available. |
LINECALLPARTYID_OUTOFAREA | Caller identifier data for the call is not available because it is not propagated completely by the network. |
LINECALLPARTYID_NAME | The caller identifier data for the call is the caller’s name taken from a table maintained inside the switch. It is provided in the caller identifier name field. |
LINECALLPARTYID_ADDRESS | The caller identifier data for the call is the caller’s number and is provided in the caller identifier field. |
LINECALLPARTYID_PARTIAL | Caller identifier data for the call is valid, but is limited to partial number data. |
LINECALLPARTYID_UNKNOWN | Caller identifier data is currently unknown, but it may be identified later. |
LINECALLPARTYID_UNAVAIL | Caller identifier data is unavailable and cannot be identified later. |
dwCallerIDSize
dwCallerIDOffset
Specify the size, in bytes, of the field that contains the caller identifier number data, and the offset, in bytes, from the beginning of this data structure.
dwCallerIDNameSize
dwCallerIDNameOffset
Specify the size, in bytes, of the field that contains the caller party identifier name data, and the offset, in bytes, from the beginning of this data structure.
dwCalledIDFlags
Determines the validity and content of the called-party identifier data. The called party corresponds to the originally addressed party. It uses the following LINECALLPARTYID_ constants:
Value | Description |
LINECALLPARTYID_BLOCKED | Called identifier data for the call has been blocked by the caller, but would otherwise have been available. |
LINECALLPARTYID_OUTOFAREA | Caller identifier data for the call is not available because it is not propagated all the way by the network. |
LINECALLPARTYID_NAME | The called identifier data for the call is the caller’s name (from a table maintained inside the switch). It is provided in the called identifier name field. |
LINECALLPARTYID_ADDRESS | The called identifier data for the call is the caller’s number and is provided in the called identifier field. |
LINECALLPARTYID_PARTIAL | Called identifier data for the call is valid, but is limited to partial number data. |
LINECALLPARTYID_UNKNOWN | Called identifier data is currently unknown, but it may be identified later. |
LINECALLPARTYID_UNAVAIL | Called identifier data is unavailable and cannot be identified later. |
dwCalledIDSize
dwCalledIDOffset
Specify the size, in bytes, of the field that contains the called-party identifier number data, and the offset, in bytes, from the beginning of this data structure.
dwCalledIDNameSize
dwCalledIDNameOffset
Specify the size, in bytes, of the field that contains the called-party identifier name data, and the offset, in bytes, from the beginning of this data structure.
dwConnectedIDFlags
Determines the validity and content of the connected party identifier data. The connected party is the party that was actually connected to. This may be different from the called-party identifier if the call was diverted. It uses the following LINECALLPARTYID_ constants:
Value | Description |
LINECALLPARTYID_BLOCKED | Connected party identifier data for the call has been blocked by the caller, but would otherwise have been available. |
LINECALLPARTYID_OUTOFAREA | Connected identifier data for the call is not available as it is not propagated all the way by the network. |
LINECALLPARTYID_NAME | The connected party identifier data for the call is the caller’s name (from a table maintained inside the switch). It is provided in the connected identifier name field. |
LINECALLPARTYID_ADDRESS | The connected party identifier data for the call is the caller’s number and is provided in the connected identifier field. |
LINECALLPARTYID_PARTIAL | Connected party identifier data for the call is valid, but is limited to partial number data. |
LINECALLPARTYID_UNKNOWN | Connected party identifier data is currently unknown, but it may be identified later. |
LINECALLPARTYID_UNAVAIL | Connected party identifier data is unavailable and cannot be identified later. |
dwConnectedIDSize
dwConnectedIDOffset
Specify the size, in bytes, of the field that contains the connected party identifier number data, and the offset, in bytes, from the beginning of this data structure.
dwConnectedIDNameSize
dwConnectedIDNameOffset
Specify the size, in bytes, of the field that contains the connected party identifier name data, and the offset, in bytes, from the beginning of this data structure.
dwRedirectionIDFlags
Determines the validity and content of the redirection party identifier data. The redirection party identifies to the calling user the number toward which diversion was invoked. It uses the following LINECALLPARTYID_ constants:
Value | Description |
LINECALLPARTYID_BLOCKED | Redirection party identifier data for the call has been blocked by the caller, but would otherwise have been available. |
LINECALLPARTYID_OUTOFAREA | Redirection identifier data for the call is not available because it is not propagated all the along the network. |
LINECALLPARTYID_NAME | The redirection party identifier data for the call is the caller’s name (from a table maintained inside the switch). It is provided in the redirection identifier name field. |
LINECALLPARTYID_ADDRESS | The redirection party identifier data for the call is the caller’s number and is provided in the redirection identifier field. |
LINECALLPARTYID_PARTIAL | Redirection party identifier data for the call is valid, but is limited to partial number data. |
LINECALLPARTYID_UNKNOWN | Redirection identifier data is currently unknown, but it may be identified later. |
LINECALLPARTYID_UNAVAIL | Redirection identifier data is unavailable and cannot be identified later. |
dwRedirectionIDSize
dwRedirectionIDOffset
Specify the size, in bytes, of the field that contains the redirection party identifier number data, and the offset, in bytes, from the beginning of this data structure.
dwRedirectionIDNameSize
dwRedirectionIDNameOffset
Specify the size, in bytes, of the field that contains the redirection party identifier name data, and the offset, in bytes, from the beginning of this data structure.
dwRedirectingIDFlags
Determines the validity and content of the redirecting party identifier data. The party that received the call identifies the new destination number or whatever data is detected to the call originator. It uses the following LINECALLPARTYID_* constants:
Value | Description |
LINECALLPARTYID_BLOCKED | Redirecting party identifier data for the call has been blocked by the caller, but would otherwise have been available. |
LINECALLPARTYID_OUTOFAREA | Redirecting identifier data for the call is not available because it is not propagated all the way by the network. |
LINECALLPARTYID_NAME | The redirecting party identifier data for the call is the caller’s name (from a table maintained inside the switch). It is provided in the redirecting identifier name field. |
LINECALLPARTYID_ADDRESS | The redirecting party identifier data for the call is the caller’s number and is provided in the redirecting identifier field. |
LINECALLPARTYID_PARTIAL | Redirecting party identifier data for the call is valid, but is limited to partial number data. |
LINECALLPARTYID_UNKNOWN | Redirecting identifier data is currently unknown, but it may be identified later. |
LINECALLPARTYID_UNAVAIL | Redirecting identifier data is unavailable and cannot be identified later. |
dwRedirectingIDSize
dwRedirectingIDOffset
Specify the size, in bytes, of the field that contains the redirecting party identifier number data, and the offset, in bytes, from the beginning of this data structure.
dwRedirectingIDNameSize
dwRedirectingIDNameOffset
Specify the size, in bytes, of the field that contains the redirecting party identifier name data, and the offset, in bytes, from the beginning of this data structure.
dwAppNameSize
dwAppNameOffset
Specify the size, in bytes, and the offset, in bytes, from the beginning of this data structure of the field that holds the user-friendly application name of the application that first originated, accepted, or answered the call. This is the name that an application can specify in lineInitializeEx. If the application specifies no such name, then the application’s module file name is used instead.
dwDisplayableAddressSize
dwDisplayableAddressOffset
Specify the displayable string is used for logging purposes. The data is obtained from LINECALLPARAMS for functions that initiate calls. The lineTranslateAddress function returns appropriate data to be placed in this member in the dwDisplayableAddressSize and dwDisplayableAddressOffset members of the LINETRANSLATEOUTPUT structure.
dwCalledPartySize
dwCalledPartyOffset
Specify the size, in bytes, of the field that holds a user-friendly description of the called party, and the offset, in bytes, from the beginning of this data structure. This data can be specified with lineMakeCall and can be optionally specified in the lpCallParams parameter whenever a new call is established. It is useful for call logging purposes.
dwCommentSize
dwCommentOffset
Specify the size, in bytes, of the field that holds a comment about the call provided by the application that originated the call using lineMakeCall, and the offset, in bytes, from the beginning of this data structure. This data can be optionally specified in the lpCallParams parameter whenever a new call is established.
dwDisplaySize
dwDisplayOffset
Specify the size, in bytes, of the field that holds raw display data, and the offset, in bytes, from the beginning of this data structure. Depending on the telephony environment, a service provider may extract functional data from this member pair for formatting and presentation most appropriate for this telephony configuration.
dwUserUserInfoSize
dwUserUserInfoOffset
Specify the size, in bytes, of the field that holds user-user data, and the offset, in bytes, from the beginning of this data structure The protocol discriminator field for the user-user data, if used, appears as the first byte of the data pointed to by dwUserUserInfoOffset, and is accounted for in dwUserUserInfoSize.
dwHighLevelCompSize
dwHighLevelCompOffset
Specify the size, in bytes, of the field that holds high-level compatibility data, and the offset, in bytes, from the beginning of this data structure. The format of this data is specified by other standards (ISDN Q.931).
dwLowLevelCompSize
dwLowLevelCompOffset
Specify the size, in bytes, of the field that holds low-level compatibility data, and the offset, in bytes, from the beginning of this data structure. The format of this data is specified by other standards (ISDN Q.931).
dwChargingInfoSize
dwChargingInfoOffset
Specify the size, in bytes, of the field that holds charging data, and the offset, in bytes, from the beginning of this data structure. The format of this data is specified by other standards (ISDN Q.931).
dwTerminalModesSize
dwTerminalModesOffset
Specify the size, in bytes, of the variably sized device field that contains an array with DWORD-sized entries, and the offset, in bytes, from the beginning of this data structure. The set of LINETERMMODE_ constants is indexed by terminal identifiers, in the range from zero to one less than dwNumTerminals. Each entry in the array specifies the current terminal modes for the corresponding terminal set with the lineSetTerminal function for this call’s media stream. The following values are predefined:
Value | Description |
LINETERMMODE_LAMPS | Lamp events sent from the line to the terminal. |
LINETERMMODE_BUTTONS | Button-press events sent from the terminal to the line. |
LINETERMMODE_DISPLAY | Display data sent from the line to the terminal. |
LINETERMMODE_RINGER | Ringer-control data sent from the switch to the terminal. |
LINETERMMODE_HOOKSWITCH | Hookswitch event sent between the terminal and the line. |
LINETERMMODE_MEDIATOLINE | The unidirectional media stream from the terminal to the line associated with a call on the line. Use this value when the routing of both unidirectional channels of a call’s media stream can be controlled independently. |
LINETERMMODE_MEDIAFROMLINE | The unidirectional media stream from the line to the terminal associated with a call on the line. Use this value when the routing of both unidirectional channels of a call’s media stream can be controlled independently. |
LINETERMMODE_MEDIABIDIRECT | The bidirectional media stream associated with a call on the line and the terminal. Use this value when the routing of both the unidirectional channels of a call’s media stream cannot be controlled independently. |
dwDevSpecificSize
dwDevSpecificOffset
Specify the size, in bytes, of the field that holds device-specific data., and the offset, in bytes, from the beginning of this data structure.
Remarks
Device-specific extensions should use the DevSpecific (dwDevSpecificSize and dwDevSpecificOffset) variably sized area of this data structure.
The LINECALLINFO data structure contains relatively fixed data about a call. This structure is returned with lineGetCallInfo. When data items in this data structure have changed, a LINE_CALLINFO message is sent to the application. A parameter to this message is the data item or field that changed.
The members dwCallTreatment through dwReceivingFlowspecOffset are available only to applications that open the line device with an API version of 2.0 or later.
Note The preferred format for specification of the contents of the dwCallID member and the other five similar members (dwCallerIDFlag, dwCallerIDSize, dwCallerIDOffset, dwCallerIDNameSize, and dwCallerIDNameOffset) is the TAPI canonical number format. For example, a ICLID of “4258828080” received from the switch should be converted to “+1 (425) 8828080” before being placed in the LINECALLINFO structure. This standardized format facilitates searching of databases and callback functions implemented in applications. ¤