Compartir a través de


Estructura LINECALLINFO (tapi.h)

La estructura LINECALLINFO contiene información sobre una llamada. Esta información permanece relativamente fija durante la llamada. Varias funciones usan LINECALLINFO. La función lineGetCallInfo devuelve la estructura y la función TSPI_lineGetCallInfo . Si una parte de la estructura cambia, se envía un mensaje LINE_CALLINFO a la aplicación que indica qué elemento de información ha cambiado.

La información de cambio dinámico de una llamada, como el estado del progreso de la llamada, está disponible en la estructura LINECALLSTATUS , devuelta por una llamada a la función lineGetCallStatus .

Sintaxis

typedef struct linecallinfo_tag {
  DWORD          dwTotalSize;
  DWORD          dwNeededSize;
  DWORD          dwUsedSize;
  HLINE          hLine;
  DWORD          dwLineDeviceID;
  DWORD          dwAddressID;
  DWORD          dwBearerMode;
  DWORD          dwRate;
  DWORD          dwMediaMode;
  DWORD          dwAppSpecific;
  DWORD          dwCallID;
  DWORD          dwRelatedCallID;
  DWORD          dwCallParamFlags;
  DWORD          dwCallStates;
  DWORD          dwMonitorDigitModes;
  DWORD          dwMonitorMediaModes;
  LINEDIALPARAMS DialParams;
  DWORD          dwOrigin;
  DWORD          dwReason;
  DWORD          dwCompletionID;
  DWORD          dwNumOwners;
  DWORD          dwNumMonitors;
  DWORD          dwCountryCode;
  DWORD          dwTrunk;
  DWORD          dwCallerIDFlags;
  DWORD          dwCallerIDSize;
  DWORD          dwCallerIDOffset;
  DWORD          dwCallerIDNameSize;
  DWORD          dwCallerIDNameOffset;
  DWORD          dwCalledIDFlags;
  DWORD          dwCalledIDSize;
  DWORD          dwCalledIDOffset;
  DWORD          dwCalledIDNameSize;
  DWORD          dwCalledIDNameOffset;
  DWORD          dwConnectedIDFlags;
  DWORD          dwConnectedIDSize;
  DWORD          dwConnectedIDOffset;
  DWORD          dwConnectedIDNameSize;
  DWORD          dwConnectedIDNameOffset;
  DWORD          dwRedirectionIDFlags;
  DWORD          dwRedirectionIDSize;
  DWORD          dwRedirectionIDOffset;
  DWORD          dwRedirectionIDNameSize;
  DWORD          dwRedirectionIDNameOffset;
  DWORD          dwRedirectingIDFlags;
  DWORD          dwRedirectingIDSize;
  DWORD          dwRedirectingIDOffset;
  DWORD          dwRedirectingIDNameSize;
  DWORD          dwRedirectingIDNameOffset;
  DWORD          dwAppNameSize;
  DWORD          dwAppNameOffset;
  DWORD          dwDisplayableAddressSize;
  DWORD          dwDisplayableAddressOffset;
  DWORD          dwCalledPartySize;
  DWORD          dwCalledPartyOffset;
  DWORD          dwCommentSize;
  DWORD          dwCommentOffset;
  DWORD          dwDisplaySize;
  DWORD          dwDisplayOffset;
  DWORD          dwUserUserInfoSize;
  DWORD          dwUserUserInfoOffset;
  DWORD          dwHighLevelCompSize;
  DWORD          dwHighLevelCompOffset;
  DWORD          dwLowLevelCompSize;
  DWORD          dwLowLevelCompOffset;
  DWORD          dwChargingInfoSize;
  DWORD          dwChargingInfoOffset;
  DWORD          dwTerminalModesSize;
  DWORD          dwTerminalModesOffset;
  DWORD          dwDevSpecificSize;
  DWORD          dwDevSpecificOffset;
  DWORD          dwCallTreatment;
  DWORD          dwCallDataSize;
  DWORD          dwCallDataOffset;
  DWORD          dwSendingFlowspecSize;
  DWORD          dwSendingFlowspecOffset;
  DWORD          dwReceivingFlowspecSize;
  DWORD          dwReceivingFlowspecOffset;
  DWORD          dwCallerIDAddressType;
  DWORD          dwCalledIDAddressType;
  DWORD          dwConnectedIDAddressType;
  DWORD          dwRedirectionIDAddressType;
  DWORD          dwRedirectingIDAddressType;
} LINECALLINFO, *LPLINECALLINFO;

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.

hLine

Controle el dispositivo de línea con el que está asociada esta llamada.

dwLineDeviceID

Identificador de dispositivo del dispositivo de línea con el que está asociada esta llamada.

dwAddressID

Identificador de dirección de la dirección en la línea en la que existe esta llamada. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwBearerMode

Modo de portador actual de la llamada. Este miembro usa una de las constantes LINEBEARERMODE_.

dwRate

Velocidad del flujo de datos de la llamada, en bps (bits por segundo).

dwMediaMode

Tipo de medio de la secuencia de información que se encuentra actualmente en la llamada. Este es el tipo de medio determinado por el propietario de la llamada, que no es necesariamente el mismo que el del último mensaje de LINE_MONITORMEDIA . Este miembro no se ve afectado directamente por los mensajes de LINE_MONITORMEDIA. Este miembro usa las constantes LINEMEDIAMODE_.

dwAppSpecific

No interpretado por la implementación de la API y el proveedor de servicios. Se puede establecer mediante cualquier aplicación propietaria de esta llamada con la función lineSetAppSpecific .

dwCallID

En algunos entornos de telefonía, el conmutador o el proveedor de servicios pueden asignar un identificador único a cada llamada. Esto permite realizar un seguimiento de la llamada entre transferencias, reenvíos u otros eventos. El dominio de estos identificadores de llamada y su ámbito es definido por el proveedor de servicios. El miembro dwCallID hace que este identificador único esté disponible para las aplicaciones.

dwRelatedCallID

Los entornos de telefonía que usan el identificador de llamada a menudo pueden encontrar que es necesario relacionar una llamada a otra. El proveedor de servicios puede usar el miembro dwRelatedCallID para este fin.

dwCallParamFlags

Colección de parámetros relacionados con llamadas cuando la llamada es saliente. Estos son los mismos parámetros de llamada especificados en lineMakeCall, una o varias de las constantes LINECALLPARAMFLAGS_.

dwCallStates

Una o varias de las constantes LINECALLSTATE_, que indica los estados en los que se puede notificar la aplicación en esta llamada. El miembro dwCallStates es constante en LINECALLINFO y no cambia según el estado de llamada.

dwMonitorDigitModes

Varios modos de dígitos. Este miembro es una o varias de las constantes LINEDIGITMODE_, para las que la supervisión está habilitada actualmente.

dwMonitorMediaModes

Varios tipos de medios para los que la supervisión está habilitada actualmente. Este miembro es una o varias de las constantes LINEMEDIAMODE_.

DialParams

Los parámetros de marcado actualmente están en vigor en la llamada, de tipo LINEDIALPARAMS. A menos que estos parámetros se establezcan mediante lineMakeCall o lineSetCallParams, sus valores son los mismos que los predeterminados usados en la estructura LINEDEVCAPS .

dwOrigin

Identifica dónde se originó la llamada. Este miembro puede ser una de las constantes LINECALLORIGIN_.

dwReason

Motivo por el que se produjo la llamada. Este miembro puede ser una de las constantes LINECALLREASON_.

dwCompletionID

Identificador de finalización de la llamada entrante si es el resultado de una solicitud de finalización que finaliza. Este identificador solo es significativo si dwReason está LINECALLREASON_CALLCOMPLETION.

dwNumOwners

Número de módulos de aplicación con identificadores de llamada diferentes con privilegios de propietario para la llamada.

dwNumMonitors

Número de módulos de aplicación con diferentes identificadores de llamada con privilegios de supervisión para la llamada.

dwCountryCode

Código de país o región de la entidad de destino. Cero si se desconoce.

dwTrunk

Número del tronco sobre el que se enruta la llamada. Este miembro se usa para las llamadas entrantes y salientes. El miembro dwTrunk debe establecerse en 0xFFFFFFFF si se desconoce.

dwCallerIDFlags

Determina la validez y el contenido del autor de la llamada, o la información del identificador de entidad. Este miembro usa una de las constantes LINECALLPARTYID_.

dwCallerIDSize

Tamaño del número de identificador del autor de la llamada, en bytes.

dwCallerIDOffset

Desfase desde el principio de esta estructura hasta el campo de tamaño variable que contiene la información del número de identificación del autor de la llamada. DwCallerIDSize especifica el tamaño del campo.

dwCallerIDNameSize

Tamaño del nombre del identificador de llamada, incluido el terminador null, en bytes.

dwCallerIDNameOffset

Desfase desde el principio de esta estructura hasta el campo de tamaño variable que contiene la información del nombre del id. de entidad de llamada. El tamaño del campo se especifica mediante dwCallerIDNameSize.

dwCalledIDFlags

Determina la validez y el contenido de la información de id. de entidad llamada. La parte llamada corresponde a la parte dirigida originalmente. Este miembro usa una de las constantes LINECALLPARTYID_.

dwCalledIDSize

Tamaño del número de id. de entidad llamado, en bytes.

dwCalledIDOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene la información de número de identificación de entidad llamada. DwCalledIDSize especifica el tamaño del campo.

dwCalledIDNameSize

Tamaño del nombre de identificador de entidad llamado, incluido el terminador null, en bytes.

dwCalledIDNameOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene la información de nombre de id. de entidad llamada. El tamaño del campo se especifica mediante dwCalledIDNameSize.

dwConnectedIDFlags

Determina la validez y el contenido de la información del identificador de entidad conectada. La entidad conectada es la que realmente estaba conectada. Esto puede ser diferente del identificador de usuario llamado si la llamada se desvía. Este miembro usa una de las constantes LINECALLPARTYID_.

dwConnectedIDSize

Tamaño del número de identificador de entidad conectada, en bytes.

dwConnectedIDOffset

Desfase desde el principio de esta estructura hasta el campo de tamaño variable que contiene la información del número de identificación de entidad conectada. El tamaño del campo se especifica mediante dwConnectedIDSize.

dwConnectedIDNameSize

Tamaño del nombre del identificador de entidad conectada, incluido el terminador nulo, en bytes.

dwConnectedIDNameOffset

Desfase desde el principio de esta estructura hasta el campo de tamaño variable que contiene la información del nombre del identificador de entidad conectada. El tamaño del campo se especifica mediante dwConnectedIDNameSize.

dwRedirectionIDFlags

Determina la validez y el contenido de la información del identificador de entidad de redirección. La entidad de redireccionamiento identifica la dirección a la que se redirigió la sesión. Este miembro usa una de las constantes LINECALLPARTYID_.

dwRedirectionIDSize

Tamaño del número de identificador de la entidad de redirección, en bytes.

dwRedirectionIDOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene la información del número de identificación de entidad de redirección. El tamaño del campo se especifica mediante dwRedirectionIDSize.

dwRedirectionIDNameSize

Tamaño del nombre del identificador de usuario de redirección, en bytes.

dwRedirectionIDNameOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene la información del nombre del identificador de usuario de redirección. El tamaño del campo se especifica mediante dwRedirectionIDNameSize.

dwRedirectingIDFlags

Determina la validez y el contenido de la información del identificador de entidad de redirección. La entidad de redireccionamiento identifica la dirección que redirige la sesión. Este miembro usa una de las constantes LINECALLPARTYID_.

dwRedirectingIDSize

Tamaño del número de identificador de usuario de redirección, en bytes.

dwRedirectingIDOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene la información del número de identificación de entidad de redirección. El tamaño del campo se especifica mediante dwRedirectingIDSize.

dwRedirectingIDNameSize

Tamaño del nombre del identificador de usuario de redirección, incluido el terminador null, en bytes.

dwRedirectingIDNameOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene la información del nombre del identificador de usuario de redireccionamiento. DwRedirectingIDNameSize especifica el tamaño del campo.

dwAppNameSize

Tamaño del campo de nombre de aplicación, incluido el terminador NULL, en bytes.

dwAppNameOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene el nombre descriptivo de la aplicación que se originó, aceptó o respondió a la llamada. Este es el nombre que una aplicación puede especificar en lineInitializeEx. Si la aplicación no especifica este nombre, se usa en su lugar el nombre de archivo del módulo de la aplicación. DwAppNameSize especifica el tamaño del campo.

dwDisplayableAddressSize

Tamaño de la cadena de dirección que se puede mostrar, incluido el terminador NULL, en bytes.

dwDisplayableAddressOffset

La cadena que se puede mostrar se usa con fines de registro. La información se obtiene de LINECALLPARAMS para funciones que inician llamadas. La función lineTranslateAddress devuelve la información adecuada que se va a colocar en este campo en los miembros dwDisplayableAddressSize y dwDisplayableAddressOffset de la estructura LINETRANSLATEOUTPUT .

dwCalledPartySize

Tamaño del campo de descripción de entidad llamado, en bytes.

dwCalledPartyOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que especifica la descripción fácil de usar de la entidad llamada. Esta información se puede especificar con lineMakeCall y se puede especificar opcionalmente en el parámetro lpCallParams siempre que se establezca una nueva llamada. Resulta útil para los fines de registro de llamadas. DwCalledPartySize especifica el tamaño del campo.

dwCommentSize

Tamaño del campo de comentario, en bytes.

dwCommentOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene un comentario sobre la llamada proporcionada por la aplicación que originó la llamada mediante lineMakeCall. Esta información se puede especificar opcionalmente en el parámetro lpCallParams cada vez que se establece una nueva llamada. DwCommentSize especifica el tamaño del campo.

dwDisplaySize

Tamaño de la información de presentación sin formato, en bytes.

dwDisplayOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información de presentación sin formato. En función del entorno de telefonía, un proveedor de servicios puede extraer información funcional de este par de miembros para dar formato y presentar la presentación más adecuada para esta configuración de telefonía. DwDisplaySize especifica el tamaño del campo.

dwUserUserInfoSize

Tamaño de la información de usuario-usuario, en bytes. Si la información del usuario es un puntero a una cadena, el tamaño debe incluir el terminador NULL.

dwUserUserInfoOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene información del usuario-usuario. El campo discriminador de protocolo para la información del usuario, si se usa, aparece como el primer byte de los datos a los que apunta dwUserUserInfoOffset y se tiene en cuenta en dwUserUserInfoSize.

dwHighLevelCompSize

Tamaño de la información de compatibilidad de alto nivel, en bytes.

dwHighLevelCompOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información de compatibilidad de alto nivel. El formato de esta información se especifica mediante otros estándares (ISDN Q.931). DwHighLevelCompSize especifica el tamaño del campo.

dwLowLevelCompSize

Tamaño de la información de compatibilidad de bajo nivel, en bytes.

dwLowLevelCompOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información de compatibilidad de bajo nivel. El formato de esta información se especifica mediante otros estándares (ISDN Q.931). DwLowLevelCompSize especifica el tamaño del campo.

dwChargingInfoSize

Tamaño de la información de carga, en bytes.

dwChargingInfoOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información de carga. El formato de esta información se especifica mediante otros estándares (ISDN Q.931). El tamaño del campo se especifica mediante dwChargingInfoSize.

dwTerminalModesSize

Tamaño de la matriz de modos de terminal actuales, en bytes.

dwTerminalModesOffset

Desplazamiento desde el principio de la estructura hasta el campo de dispositivo de tamaño variable que contiene una matriz con entradas de tamaño DWORD. Las entradas de matriz se indexan mediante identificadores de terminal, en el intervalo de cero a uno menor que dwNumTerminals. Cada entrada de la matriz especifica los modos de terminal actuales para el conjunto de terminales correspondiente con la función lineSetTerminal de la secuencia multimedia de esta llamada, tal como se especifica en una de las constantes de LINETERMMODE_. DwTerminalModesSize especifica el tamaño de la matriz.

dwDevSpecificSize

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

dwDevSpecificOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información específica del dispositivo. DwDevSpecificSize especifica el tamaño del campo.

dwCallTreatment

El tratamiento de llamadas que se aplica actualmente en la llamada o que se aplica cuando la llamada entra en el siguiente estado aplicable. Puede ser cero si no se admiten tratamientos de llamada.

dwCallDataSize

Tamaño de los datos de llamada que se pueden establecer en la aplicación, en bytes.

dwCallDataOffset

Desplazamiento desde el principio de la estructura hasta los datos de llamada que se pueden establecer en la aplicación. DwCallDataSize especifica el tamaño del campo.

dwSendingFlowspecSize

Tamaño de la calidad de la información del servicio, en bytes.

dwSendingFlowspecOffset

Desplazamiento desde el principio de la estructura a una estructura FLOWSPEC seguida de datos específicos del proveedor de WinSock, equivalentes a lo que se habría almacenado en SendingFlowspec en una estructura QOS . Especifica la calidad del servicio actualmente en vigor en la dirección de envío en la llamada. La parte específica del proveedor que sigue a la estructura FLOWSPEC no debe contener punteros a otros bloques de memoria, ya que TAPI no sabe cómo serializar los datos a los que apuntan los punteros privados y transmitirlos a través de la comunicación entre procesos a la aplicación. DwSendingFlowspecSize especifica el tamaño del campo.

dwReceivingFlowspecSize

Tamaño de la calidad de la información del servicio, en bytes.

dwReceivingFlowspecOffset

Desplazamiento desde el principio de la estructura a una estructura FLOWSPEC seguida de datos específicos del proveedor de WinSock, equivalentes a lo que se habría almacenado en ReceiveingFlowspec en una estructura QOS . Especifica la calidad del servicio actual en vigor en la dirección de recepción de la llamada. La parte específica del proveedor que sigue a la estructura FLOWSPEC no debe contener punteros a otros bloques de memoria, ya que TAPI no sabe cómo serializar los datos a los que apuntan los punteros privados y transmitirlos a través de la comunicación entre procesos a la aplicación. DwReeplyFlowspecSize especifica el tamaño del campo.

dwCallerIDAddressType

Tipo de dirección del autor de la llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

dwCalledIDAddressType

Tipo de dirección de la entidad llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

dwConnectedIDAddressType

Tipo de dirección del destino al que se conectó realmente la llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

dwRedirectionIDAddressType

Tipo de dirección del nuevo destino de llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

dwRedirectingIDAddressType

Tipo de dirección de la ubicación que redireccionó la llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

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 estructura de datos LINECALLINFO contiene información relativamente fija sobre una llamada. Esta estructura se devuelve con lineGetCallInfo. Cuando los elementos de información de esta estructura de datos han cambiado, se envía un mensaje LINE_CALLINFO a la aplicación. Un parámetro para este mensaje es el elemento de información o campo que cambió.

Los miembros dwCallTreatment a través de dwRetectedFlowspecOffset 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.

Nota El formato preferido para la especificación del contenido del campo dwCallID y los otros cinco campos similares (dwCallerIDFlag, dwCallerIDSize, dwCallerIDOffset, dwCallerIDNameSize y dwCallerIDNameOffset) es el formato de número canónico TAPI. Por ejemplo, un ICLID de "4258828080" recibido del modificador debe convertirse a "+1 (425) 8828080" antes de colocarse en la estructura LINECALLINFO . Este formato estandarizado facilita la búsqueda de bases de datos y funciones de devolución de llamada implementadas en aplicaciones.
 

Requisitos

Requisito Valor
Header tapi.h

Consulte también

LINECALLSTATUS

LINEDEVCAPS

LINEDIALPARAMS

LINETRANSLATEOUTPUT

LINE_CALLINFO

LINE_MONITORMEDIA

TSPI_lineGetCallInfo

lineGenerateDigits

lineGetCallInfo

lineGetCallStatus

lineInitializeEx

lineMakeCall

lineSecureCall

lineSetAppSpecific

lineSetCallParams

lineSetTerminal

lineTranslateAddress