LINECALLINFO

The LINECALLINFO structure contains information about a call. This information remains relatively fixed for the duration of the call and is obtained using TSPI_lineGetCallInfo. If a part of the structure does change, a LINE_CALLINFO message is sent to the application indicating which information item has changed. Dynamically changing information about a call, such as call progress status, is available in the LINECALLSTATUS structure, returned with the function TSPI_lineGetCallStatus.

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
The total size in bytes allocated to this data structure.
dwNeededSize
The size in bytes for this data structure that is needed to hold all returned information.
dwUsedSize
The size in bytes of the portion of this data structure that contains useful information.
hLine
Handle for the line device with which this call is associated.
dwLineDeviceID
The device identifier of the line device with which this call is associated.
dwAddressID
The address identifier of the address on the line on which this call exists.
dwBearerMode
The current bearer mode of the call. This member uses the following LINEBEARERMODE_ constants:
LINEBEARERMODE_VOICE
Regular 3.1kHz analog voice grade bearer service. Bit integrity is not assured. Voice can support fax and modem media modes.
LINEBEARERMODE_SPEECH
Corresponds to G.711 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
Corresponds to a non-call-associated signaling connection from the application to the service provider or switch (treated as a media stream by the Telephony API).
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 comm functions, for the purpose of configuring or using special features not otherwise supported by the service provider.
dwRate
The rate of the call's data stream in bps (bits per second).
dwMediaMode
The media mode of the information stream currently on the call, of type LINEMEDIAMODE_. This is the media mode as 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 LINE_MONITORMEDIA messages. Values are:
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 inbound call's media mode may be unknown until after the call is answered and the media stream is filtered to make a determination.
LINEMEDIAMODE_INTERACTIVEVOICE
The presence of voice energy on the call and the call is treated as an interactive call with humans on both ends.
LINEMEDIAMODE_AUTOMATEDVOICE
The presence of voice energy 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 over the call.
LINEMEDIAMODE_TDD
A TDD (Telephony Devices for the Deaf) session on the call.
LINEMEDIAMODE_G4FAX
A group 4 fax is being sent or received over the call.
LINEMEDIAMODE_DIGITALDATA
Digital data is being sent or received over the call.
LINEMEDIAMODE_TELETEX
A teletex session on the call. Teletex is one of the telematic services.
LINEMEDIAMODE_VIDEOTEX
A videotex session on the call. Videotex is one the telematic services.
LINEMEDIAMODE_TELEX
A telex session on the call. Telex is one 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
This member is uninterpreted by the API implementation and service provider. It can be set by any owner application of this call with TSPI_lineSetAppSpecific.
dwCallID
In some telephony environments, the switch or service provider can assign a unique identifier to each call. This allows 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 ID 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
A collection of call-related parameters when the call is outbound. These are the same call parameters specified through TSPI_lineMakeCall, of type LINECALLPARAMFLAGS_. Values are:
LINECALLPARAMFLAGS_SECURE
The call is currently secure. This flag is also updated if the call is later secured with TSPI_lineSecureCall.
LINECALLPARAMFLAGS_IDLE
The call started out using an idle call.
LINECALLPARAMFLAGS_BLOCKID
The originator identity is concealed (blocked caller ID presentation to the remote party).
LINECALLPARAMFLAGS_ORIGOFFHOOK
The originator's phone is automatically taken offhook.
LINECALLPARAMFLAGS_DESTOFFHOOK
The called party's phone is automatically taken offhook.
dwCallStates
The call states for which the application can be notified on this call. This member uses the LINECALLSTATE_ constants listed below. The dwCallStates member is constant in LINECALLINFO. It describes the call states that can be reported during the lifetime of this call, and does not change depending on call state. (LINECALLINFO should be seen as a "call caps".) Values are:
LINECALLSTATE_IDLE
The call is idle; no call actually exists.
LINECALLSTATE_OFFERING
The call is being 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; alerting is done by the switch instructing the line to ring. It does not affect any call states.
LINECALLSTATE_ACCEPTED
The call was offering and is accepted. This indicates to other (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 information (a phone number) is being sent to the switch over the call. Note that the operation TSPI_lineGenerateDigits does not place the line into the dialing state.
LINECALLSTATE_RINGBACK
The call is receiving 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 tone. Busy tone indicates that the call cannot be completed because either a circuit (trunk) or the remote party's station are in use.
LINECALLSTATE_SPECIALINFO
Special information is sent by the network. Special information is typically sent when the destination cannot be reached.
LINECALLSTATE_CONNECTED
The call is established, the connection is made. Information is able to flow over the call between the originating address and the destination address.
LINECALLSTATE_PROCEEDING
Dialing is 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 it is being added to a conference.
LINECALLSTATE_ONHOLDPENDTRANSFER
The call is currently on hold awaiting transfer to another number.
LINECALLSTATE_DISCONNECTED
The remote party has disconnected from the call.
LINECALLSTATE_UNKNOWN
The state of the call is not known. This can be due to limitations of the call progress detection implementation.
dwMonitorDigitModes
The various digit modes for which monitoring is currently enabled. This member uses the following LINEDIGITMODE_ constants:
LINEDIGITMODE_PULSE
Use pulse/rotary for digit signaling.
LINEDIGITMODE_DTMF
Use DTMF tones for digit signaling.
LINEDIGITMODE_DTMFEND
Use DTMF tones for digit detection, and also detect the down edges.
dwMonitorMediaModes
The various media modes for which monitoring is currently enabled. This member uses the following LINEMEDIAMODE_ constants:
LINEMEDIAMODE_INTERACTIVEVOICE
The presence of voice energy on the call and the call is treated as an interactive call with humans on both ends.
LINEMEDIAMODE_AUTOMATEDVOICE
The presence of voice energy 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 over the call.
LINEMEDIAMODE_TDD
A TDD (Telephony Devices for the Deaf) session on the call.
LINEMEDIAMODE_G4FAX
A group 4 fax is being sent or received over the call.
LINEMEDIAMODE_DIGITALDATA
Digital data is being sent or received over the call.
LINEMEDIAMODE_TELETEX
A teletex session on the call. Teletex is one of the telematic services.
LINEMEDIAMODE_VIDEOTEX
A videotex session on the call. Videotex is one the telematic services.
LINEMEDIAMODE_TELEX
A telex session on the call. Telex is one the telematic services.
LINEMEDIAMODE_MIXED
A mixed session on the call. Mixed is one 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 TSPI_lineMakeCall or TSPI_lineSetCallParams, their values are the same as the defaults used in LINEDEVCAPS.
dwOrigin
Identifies where the call originated from. This member uses the following LINECALLORIGIN_ constants:
LINECALLORIGIN_OUTBOUND
The call is an outbound call.
LINECALLORIGIN_INTERNAL
The call is inbound and originated internally (on the same PBX, for example).
LINECALLORIGIN_EXTERNAL
The call is inbound and originated externally.
LINECALLORIGIN_UNKNOWN
The call is an inbound call, but its origin is currently unknown but can become known later.
LINECALLORIGIN_UNAVAIL
The call is an inbound call, and its origin is not available and cannot become known for this call.
LINECALLORIGIN_CONFERENCE
The call handle is for a conference call, that is, the application's connection to the conference bridge in the switch.
dwReason
The reason why the call occurred. This member uses the following LINECALLREASON_ constants:
LINECALLREASON_DIRECT
This is a direct call.
LINECALLREASON_FWDBUSY
This 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 didn't 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 information can indicate who the caller is and where the call was transferred from.
LINECALLREASON_REMINDER
The call is a reminder (or recall) that the user has a call parked or on hold for potentially a long time.
LINECALLREASON_UNKNOWN
The reason for the call is currently unknown but can become known later.
LINECALLREASON_UNAVAIL
The reason for the call is unavailable and cannot become known later.
dwCompletionID
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
The number of application modules with different call handles with owner privilege for the call.
dwNumMonitors
The number of application modules with different call handles with monitor privilege for the call.
dwCountryCode
The country code of the destination party. Zero if unknown.
dwTrunk
The number of the trunk over which the call is routed. This member is used for both inbound and outgoing calls, and should be set to 0xFFFFFFFF if it is unknown.
dwCallerIDFlags
Determines the validity and content of the caller party identifier information. The caller is the originator of the call. This member uses the following LINECALLPARTYID_ constants:
LINECALLPARTYID_BLOCKED
Caller ID information for the call is blocked by the caller, but would otherwise be available.
LINECALLPARTYID_OUTOFAREA
Caller ID information for the call is not available because it is not propagated all the way by the network.
LINECALLPARTYID_NAME
The caller ID information for the call is the caller's name (from a table maintained inside the switch). It is provided in the caller ID name variably sized field.
LINECALLPARTYID_ADDRESS
The caller ID information for the call is the caller's number, and is provided in the caller ID variably sized field.
LINECALLPARTYID_PARTIAL
Caller ID information for the call is valid, but is limited to partial number information.
LINECALLPARTYID_UNKNOWN
Caller ID information is currently unknown, but it can become known later.
LINECALLPARTYID_UNAVAIL
Caller ID information is unavailable and cannot become known later.
dwCallerIDSize
dwCallerIDOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the caller party ID number information.
dwCallerIDNameSize
dwCallerIDNameOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the caller party ID name information.
dwCalledIDFlags
Determines the validity and content of the called party ID information. The called party corresponds to the orignally addressed party. This member uses the following LINECALLPARTYID_ constants:
LINECALLPARTYID_BLOCKED
Called ID information for the call is blocked by the caller, but would otherwise be available.
LINECALLPARTYID_OUTOFAREA
Caller ID information for the call is not available as it is not propagated all the way by the network.
LINECALLPARTYID_NAME
The called ID information for the call is the caller's name (from a table maintained inside the switch). It is provided in the called ID name variably sized field.
LINECALLPARTYID_ADDRESS
The called ID information for the call is the caller's number, and is provided in the called ID variably sized field.
LINECALLPARTYID_PARTIAL
Called ID information for the call is valid, but is limited to partial number information.
LINECALLPARTYID_UNKNOWN
Called ID information is currently unknown but it can become known later.
LINECALLPARTYID_UNAVAIL
Called ID information is unavailable and cannot become known later.
dwCalledIDSize
dwCalledIDOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the called party ID number information.
dwCalledIDNameSize
dwCalledIDNameOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the called party ID name information.
dwConnectedFlags
Determines the validity and content of the connected party ID information. The connected party is the party that was actually connected to. This can be different from the called party ID if the call was diverted. This member uses the following LINECALLPARTYID_ constants:
LINECALLPARTYID_BLOCKED
Connected party identifier information for the call is blocked by the caller, but would otherwise be available.
LINECALLPARTYID_OUTOFAREA
Connected identifier information for the call is not available as it is not propagated all the way by the network.
LINECALLPARTYID_NAME
The connected party identifier information for the call is the caller's name (from a table maintained inside the switch). It is provided in the connected identifier name variably sized field.
LINECALLPARTYID_ADDRESS
The connected party identifier information for the call is the caller's number, and is provided in the connected identifier variably sized field.
LINECALLPARTYID_PARTIAL
Connected party identifier information for the call is valid, but is limited to partial number information.
LINECALLPARTYID_UNKNOWN
Connected party identifier information is currently unknown, but can become known later.
LINECALLPARTYID_UNAVAIL
Connected party identifier information is unavailable and cannot become known later.
dwConnectedIDSize
dwConnectedIDOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the connected party identifier number information.
dwConnectedIDNameSize
dwConnectedIDNameOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the connected party identifier name information.
dwRedirectionIDFlags
Determines the validity and content of the redirection party identifier information. The redirection party identifies to the calling user the number toward which diversion was invoked. This member uses the following LINECALLPARTYID_ constants:
LINECALLPARTYID_BLOCKED
Redirection party identifier information for the call is blocked by the caller, but would otherwise be available.
LINECALLPARTYID_OUTOFAREA
Redirection identifier information for the call is not available as it is not propagated all the way by the network.
LINECALLPARTYID_NAME
The redirection party identifier information for the call is the caller's name (from a table maintained inside the switch). It is provided in the redirection ID name variably sized field.
LINECALLPARTYID_ADDRESS
The redirection party identifier information for the call is the caller's number, and is provided in the redirection identifier variably sized field.
LINECALLPARTYID_PARTIAL
Redirection party identifier information for the call is valid, but is limited to partial number information.
LINECALLPARTYID_UNKNOWN
Redirection identifier information is currently unknown but it can become known later.
LINECALLPARTYID_UNAVAIL
Redirection identifier information is unavailable and cannot become known later.
dwRedirectionIDSize
dwRedirectionIDOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the redirection party identifier number information.
dwRedirectionIDNameSize
dwRedirectionIDNameOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the redirection party identifier name information.
dwRedirectingIDFlags
Determines the validity and content of the redirecting party identifier information. The redirecting party identifies to the diverted-to user the party from which diversion was invoked. This member uses the following LINECALLPARTYID_ constants:
LINECALLPARTYID_BLOCKED
Redirecting party identifier information for the call is blocked by the caller, but would otherwise be available.
LINECALLPARTYID_OUTOFAREA
Redirecting identifier information for the call is not available because it is not propagated all the way by the network.
LINECALLPARTYID_NAME
The redirecting party identifier information for the call is the caller's name (from a table maintained inside the switch). It is provided in the redirecting identifier name variably sized field.
LINECALLPARTYID_ADDRESS
The redirecting party identifier information for the call is the caller's number, and is provided in the redirecting identifier variably sized field.
LINECALLPARTYID_PARTIAL
Redirecting party identifier information for the call is valid, but is limited to partial number information.
LINECALLPARTYID_UNKNOWN
Redirecting identifier information is currently unknown, but can become known later.
LINECALLPARTYID_UNAVAIL
Redirecting identifier information is unavailable and cannot become known later.
dwRedirectingIDSize
dwRedirectingIDOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the redirecting party identifier number information.
dwRedirectingIDNameSize
dwRedirectingIDNameOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized field containing the redirecting party identifier name information.
dwAppNameSize
dwAppNameOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding 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 with lineInitialize. If the application specifies no such name, the application's module name is used instead.
dwDisplayableAddressSize
dwDisplayableAddressOffset
The displayable string is used for logging purposes. The information is obtained from LINECALLPARAMS for functions that intiate calls. The TAPI function lineTranslateAddress returns appropriate information to be placed in this member in the dwDisplayableAddressSize and dwDisplayableAddressOffset members of the LINETRANSLATEOUTPUT structure.
dwCalledPartySize
dwCalledPartyOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding a user-friendly description of the called party. This information can be specified with TSPI_lineMakeCall and can be optionally specified with the lpCallParams parameter whenever a new call is established. It is useful for call logging purposes.
dwCommentSize
dwCommentOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding a comment about the call provided by the application that originated the call using TSPI_lineMakeCall. This information can be optionally specified with the lpCallParams parameter whenever a new call is established.
dwDisplaySize
dwDisplayOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding raw display information. Depending on the telephony environment, a service provider can extract functional information from this for presentation into a more functional way.
dwUserUserInfoSize
dwUserUserInfoOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding user-user information.
dwHighLevelCompSize
dwHighLevelCompOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding high-level compatibility information. The format of this information is specified by other standards (ISDN Q.931).
dwLowLevelCompSize
dwLowLevelCompOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding low-level compatibility information. The format of this information is specified by other standards (ISDN Q.931).
dwChargingInfoSize
dwChargingInfoOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding charging information. The format of this information is specified by other standards (ISDN Q.931).
dwTerminalModesSize
dwTerminalModesOffset
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized device field containing an array with DWORD-sized entries, of type LINETERMMODE_. This array is indexed by terminal identifiers, in the range from zero to dwNumTerminals minus one. Each entry in the array specifies the current terminal modes for the corresponding terminal set with the TSPI_lineSetTerminal function for this call's media stream. Values are:
LINETERMMODE_BUTTONS
Button press events sent from the terminal to the line.
LINETERMMODE_LAMPS
Lamp events sent from the line to the terminal.
LINETERMMODE_DISPLAY
Display information sent from the line to the terminal.
LINETERMMODE_RINGER
Ringer control information sent from the switch to the terminal.
LINETERMMODE_HOOKSWITCH
Hookswitch events 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 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 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 routing of both unidirectional channels of a call's media stream cannot be controlled independently.
dwDevSpecificSize
dwDevSpecificOffset
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field holding device-specific information.

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 information about a call. This structure is returned with TSPI_lineGetCallInfo. When information items in this data structure have changed, a LINE_CALLINFO message is sent to the application. A parameter to this message is the information item or field that changed.

The dwAppSpecific member can be used by applications to tag calls by using TSPI_lineSetAppSpecific. This member is uninterpreted by TAPI or service providers. It is initially set to zero.

See Also

LINE_CALLINFO, LINEBEARERMODE_ Constants, LINECALLORIGIN_ Constants, LINECALLPARAMFLAGS_ Constants, LINECALLPARTYID_ Constants, LINECALLREASON_ Constants, LINECALLSTATE_ Constants, LINEDIGITMODE_ Constants, LINEMEDIAMODE_ Constants, LINETERMMODE_ Constants, TSPI_lineGetCallInfo, TSPI_lineSetAppSpecific