Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure describes the current status of a call. The information in this structure depends on the device capabilities of the address, the ownership of the call by the invoking application, and the current state of the call being queried. The lineGetCallStatusand TSPI_lineGetCallStatusfunctions return the LINECALLSTATUSstructure.

Syntax 

typedef struct linecallstatus_tag {
  DWORD 
dwTotalSize;
  DWORD 
dwNeededSize;
  DWORD 
dwUsedSize;
  DWORD 
dwCallState;
  DWORD 
dwCallStateMode;
  DWORD 
dwCallPrivilege;
  DWORD 
dwCallFeatures;
  DWORD 
dwDevSpecificSize;
  DWORD 
dwDevSpecificOffset;
  DWORD 
dwCallFeatures2;
  SYSTEMTIME 
tStateEntryTime;
} LINECALLSTATUS, FAR* LPLINECALLSTATUS;

Members

dwTotalSize

Total size, in bytes, allocated to this data structure.

dwNeededSize

Size, in bytes, for this data structure that is needed to hold all the returned information.

dwUsedSize

Size, in bytes, of the portion of this data structure that contains useful information.

dwCallState

Value that specifies the current call state of the call using one of the LINECALLSTATE.

dwCallStateMode

The interpretation of the dwCallStateModemember is call-state-dependent. In many cases, the value will be zero. The following table shows dwCallStateModetypes for a given dwCallStatevalue.

dwCallState CallStateMode

LINECALLSTATE_BUSY

LINEBUSYMODE

LINECALLSTATE_CONNECTED

LINECONNECTEDMODE

LINECALLSTATE_DIALTONE

LINEDIALTONEMODE

LINECALLSTATE_DISCONNECTED

LINEDISCONNECTMODE

LINECALLSTATE_OFFERING

LINEOFFERINGMODE

LINECALLSTATE_SPECIALINFO

LINESPECIALINFO

dwCallPrivilege

The application's privilege for this call. This member uses one or more of the LINECALLPRIVILEGE.

dwCallFeatures

These flags indicate the Telephony API functions that can be invoked on the call, given the availability of the feature in the device capabilities, the current call state, and call ownership of the invoking application. A zero indicates the corresponding feature cannot be invoked by the application on the call in its current state; a one indicates the feature can be invoked. This member uses LINECALLFEATURE.

dwDevSpecificSize

Size, in bytes, of the variably sized device-specific field.

dwDevSpecificOffset

Offset, in bytes, from the beginning of this data structure.

dwCallFeatures2

Value that indicates additional functions can be invoked on the call, given the availability of the feature in the device capabilities, the current call state, and call ownership of the invoking application. An extension of the dwCallFeaturesmember. This member uses LINECALLFEATURE2.

tStateEntryTime

The Coordinated Universal Time at which the current call state was entered.

Remarks

Device-specific extensions should use the DevSpecific( dwDevSpecificSizeand dwDevSpecificOffset) variably sized area of this data structure.

The application is sent a LINE_CALLSTATEmessage whenever the call state of a call changes. This message only provides the new call state of the call. Additional status about a call is available with lineGetCallStatus.

The members dwCallFeatures2and tStateEntryTimeare available only to applications that open the line device with an API version of 2.0 or later.

Requirements

Header tapi.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also