Platform SDK: TAPI |
The LINECALLSTATUS 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 lineGetCallStatus and TSPI_lineGetCallStatus functions return the LINECALLSTATUS structure.
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;
dwCallState | dwCallStateMode |
---|---|
LINECALLSTATE_BUSY | LINEBUSYMODE_ Constants |
LINECALLSTATE_CONNECTED | LINECONNECTEDMODE_ Constants |
LINECALLSTATE_DIALTONE | LINEDIALTONEMODE_ Constants |
LINECALLSTATE_DISCONNECTED | LINEDISCONNECTMODE_ Constants |
LINECALLSTATE_OFFERING | LINEOFFERINGMODE_ Constants |
LINECALLSTATE_SPECIALINFO | LINESPECIALINFO_ Constants |
Device-specific extensions should use the DevSpecific (dwDevSpecificSize and dwDevSpecificOffset) variably sized area of this data structure.
The application is sent a LINE_CALLSTATE message 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 dwCallFeatures2 and tStateEntryTime are available only to applications that open the line device with an API version of 2.0 or later.
Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
Windows 95/98: Requires Windows 95 or later.
Version: Requires TAPI 1.4 or later.
Header: Declared in Tapi.h.
LINE_CALLSTATE, LINEDIALPARAMS, lineGetCallStatus, TSPI_lineGetCallStatus