Edit

LINEDEVSTATUS structure (tapi.h)

  • Article

The LINEDEVSTATUS structure describes the current status of a line device. The lineGetLineDevStatus function and the TSPI_lineGetLineDevStatus function return the LINEDEVSTATUS structure.

Syntax

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

Members

dwTotalSize

Total size allocated to this data structure, in bytes.

dwNeededSize

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

dwUsedSize

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

dwNumOpens

Number of active opens on the line device.

dwOpenMediaModes

Bit array that indicates for which media types the line device is currently open.

dwNumActiveCalls

Number of calls on the line in call states other than idle, onhold, onholdpendingtransfer, and onholdpendingconference.

dwNumOnHoldCalls

Number of calls on the line in the onhold state.

dwNumOnHoldPendCalls

Number of calls on the line in the onholdpendingtransfer or onholdpendingconference state.

dwLineFeatures

Line-related functions that are currently available on this line. This member uses one or more of the LINEFEATURE_ Constants.

dwNumCallCompletions

Number of outstanding call completion requests on the line.

dwRingMode

Current ring mode on the line device.

dwSignalLevel

Current signal level of the connection on the line. This is a value in the range 0x00000000 (weakest signal) to 0x0000FFFF (strongest signal).

dwBatteryLevel

Current battery level of the line device hardware. This is a value in the range 0x00000000 (battery empty) to 0x0000FFFF (battery full).

dwRoamMode

Current roam mode of the line device. This member uses one of the LINEROAMMODE_ Constants.

dwDevStatusFlags

Flags that indicate status information, such as whether the device is locked. It consists of one or more members of LINEDEVSTATUSFLAGS_ Constants.

dwTerminalModesSize

Size of the variably-sized device field containing an array of current terminal modes, in bytes.

dwTerminalModesOffset

Offset from the beginning of the structure to an array of current terminal modes, in bytes. This array is indexed by terminal IDs, in the range from zero to dwNumTerminals minus one. Each entry in the array specifies the current terminal modes for the corresponding terminal set using the lineSetTerminal function for this line. Each entry is a DWORD that specifies one or more of the LINETERMMODE_ Constants. The size of the array is specified by dwTerminalModesSize.

dwDevSpecificSize

Size of the variably sized device-specific field, in bytes. If the device-specific information is a pointer to a string, the size must include the null terminator.

dwDevSpecificOffset

Offset from the beginning of the structure to the device-specific field, in bytes. The size of the field is specified by dwDevSpecificSize.

dwAvailableMediaModes

Indicates the media types that can be invoked on new calls created on this line device, when the dwLineFeatures member indicates that new calls are possible. If this member is zero, it indicates that the service provider either does not know or cannot indicate which media types are available, in which case any or all of the media types indicated in the dwMediaModes member in LINEDEVCAPS may be available.

dwAppInfoSize

Size of the array that identifies the applications that have the line open, in bytes.

dwAppInfoOffset

Offset from the beginning of the structure to an array of LINEAPPINFO structures. The dwNumOpens member indicates the number of elements in the array. Each element in the array identifies an application that has the line open. The size of the array is specified by dwAppInfoSize.

Remarks

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

The members dwAvailableMediaModes through dwAppInfoOffset are available only to applications that open the line device with an API version of 2.0 or later.

Requirements

Requirement Value
Header tapi.h

See also

LINEAPPINFO

LINEDEVCAPS

TSPI_lineGetLineDevStatus

lineGetLineDevStatus

lineSetTerminal