Estructura LINECALLSTATUS (tapi.h)
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
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 |