LINEQUEUEINFO

The LINEQUEUEINFO structure provides information about a queue on a line device. The lineGetQueueInfo function returns the LINEQUEUEINFO structure. This structure requires TAPI 3.0 version negotiation.

typedef struct linequeueinfo_tag {
  DWORD  dwTotalSize;
  DWORD  dwNeededSize;
  DWORD  dwUsedSize;
  DWORD  dwMeasurementPeriod;
  DWORD  dwTotalCallsQueued;
  DWORD  dwCurrentCallsQueued;
  DWORD  dwTotalCallsAbandoned;
  DWORD  dwTotalCallsFlowedIn;
  DWORD  dwTotalCallsFlowedOut;
  DWORD  dwLongestEverWaitTime;
  DWORD  dwCurrentLongestWaitTime;
  DWORD  dwAverageWaitTime;
  DWORD  dwFinalDisposition;
} LINEQUEUEINFO, *LPLINEQUEUEINFO;

Members

dwTotalSize

The total size, in bytes, allocated to this structure.

dwNeededSize

The size, in bytes, needed to hold all the information requested.

dwUsedSize

The size, in bytes, of the portion of this structure that contains useful information.

dwMeasurementPeriod

The period (in seconds) for which the switch or implementation stores and calculates information. For example, dwTotalCallsAbandoned holds the number of abandoned calls; dwMeasurementPeriod would indicate if this value referenced the calls queued in an hour, day, or month, for example.

dwTotalCallsQueued

The total number of incoming calls for this queue during this measurement period.

dwCurrentCallsQueued

The number of incoming calls currently waiting.

dwTotalCallsAbandoned

The number of abandoned calls during this measurement period.

dwTotalCallsFlowedIn

The total number of calls that flowed into this queue (passed down from another queue or ACD group) during this measurement period.

dwTotalCallsFlowedOut

The total number of calls that flowed out of this queue (passed down to another queue or ACD group) during this measurement period.

dwLongestEverWaitTime

The longest time, in seconds, any call has waited in queue.

dwCurrentLongestWaitTime

The longest time, in seconds, that a current call (that is, a call still in queue) has been waiting.

dwAverageWaitTime

The average time, in seconds, that a call has waited in queue.

dwFinalDisposition

The final disposition of the queue.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Version: Requires TAPI 2.2 or later.
  Header: Declared in Tapi.h.

See Also

About TAPI 3.0 Call Center Controls, lineGetQueueInfo