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.
Requisitos
| Requisito | Valor |
|---|---|
| Header | tapi.h |