Estructura LINECALLSTATUS (tapi.h)

  • Artículo

La estructura LINECALLSTATUS describe el estado actual de una llamada. La información de esta estructura depende de las funcionalidades del dispositivo de la dirección, de la propiedad de la llamada por la aplicación invocada y del estado actual de la llamada que se está consultando. Las funciones lineGetCallStatus y TSPI_lineGetCallStatus devuelven la estructura LINECALLSTATUS .

Sintaxis

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes.

dwNeededSize

Tamaño de esta estructura de datos necesaria para contener toda la información devuelta, en bytes.

dwUsedSize

Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.

dwCallState

Estado de llamada actual de la llamada mediante una de las constantes de LINECALLSTATE_.

dwCallStateMode

La interpretación del miembro dwCallStateMode depende del estado de llamada. En muchos casos, el valor será cero. En la tabla siguiente se muestran los tipos dwCallStateMode de un valor dwCallState determinado.

dwCallState Significado
LINECALLSTATE_BUSY

constantes de LINEBUSYMODE_
LINECALLSTATE_CONNECTED

constantes de LINECONNECTEDMODE_
LINECALLSTATE_DIALTONE

constantes de LINEDIALTONEMODE_
LINECALLSTATE_DISCONNECTED

constantes de LINEDISCONNECTMODE_
LINECALLSTATE_OFFERING

constantes de LINEOFFERINGMODE_
LINECALLSTATE_SPECIALINFO

constantes de LINESPECIALINFO_

dwCallPrivilege

Privilegios de la aplicación para esta llamada. Este miembro usa una o varias de las constantes de LINECALLPRIVILEGE_.

dwCallFeatures

Marcas que indican las funciones de API de telefonía que se pueden invocar en la llamada, dada la disponibilidad de la característica en las funcionalidades del dispositivo, el estado de llamada actual y la propiedad de la llamada de la aplicación invocada. Un cero indica que la aplicación no puede invocar la característica correspondiente en la llamada en su estado actual; una indica que se puede invocar la característica. Este miembro usa constantes LINECALLFEATURE_.

dwDevSpecificSize

Tamaño del campo específico del dispositivo, en bytes.

dwDevSpecificOffset

Desplazamiento desde el principio de la estructura hasta el campo específico del dispositivo de tamaño variable. El tamaño del campo se especifica mediante dwDevSpecificOffset.

dwCallFeatures2

Indica que se pueden invocar funciones adicionales en la llamada, dada la disponibilidad de la característica en las funcionalidades del dispositivo, el estado de llamada actual y la propiedad de llamada de la aplicación invocada. Extensión del miembro dwCallFeatures . Este miembro usa constantes LINECALLFEATURE2_.

tStateEntryTime

Hora universal coordinada en la que se especificó el estado de llamada actual.

tStateEntryTime[8]

Hora universal coordinada en la que se especificó el estado de llamada actual.

Comentarios

Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.

La aplicación se envía un mensaje LINE_CALLSTATE cada vez que cambia el estado de llamada de una llamada. Este mensaje solo proporciona el nuevo estado de llamada de la llamada. El estado adicional sobre una llamada está disponible con lineGetCallStatus.

Los miembros dwCallFeatures2 y tStateEntryTime solo están disponibles para las aplicaciones que abren el dispositivo de línea con una versión de API de 2.0 o posterior.

Requisitos

Requisito Valor
Header tapi.h

Consulte también

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus