función TSPI_lineGetCallInfo (tspi.h)
La función TSPI_lineGetCallInfo devuelve información detallada sobre la llamada especificada.
Sintaxis
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
Parámetros
hdCall
El identificador del proveedor de servicios de la llamada cuya información de llamada se va a recuperar. El estado de llamada de hdCall puede ser cualquier estado.
lpCallInfo
Puntero a una estructura de datos de tamaño variable de tipo LINECALLINFO. Tras completar correctamente la solicitud, esta estructura se rellena con información relacionada con llamadas.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentarios
En la tabla siguiente se indica qué miembros de la estructura de datos LINECALLINFO están rellenados por TAPI y qué miembros rellena el proveedor de servicios. El proveedor de servicios debe conservar (no debe sobrescribir) los valores rellenados por TAPI.
| Nombre del miembro | TAPI | Proveedor de servicios |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| hLine; | X | |
| dwLineDeviceID; | X | |
| dwAddressID; | X | |
| dwBearerMode; | X | |
| dwRate; | X | |
| dwMediaMode; | X | |
| dwAppSpecific; | X | |
| dwCallID; | X | |
| dwRelatedCallID; | X | |
| dwCallParamFlags; | X | |
| dwCallStates; | X | X |
| dwMonitorDigitModes; | X | |
| dwMonitorMediaModes; | X | |
| DialParams; | X | |
| dwOrigin; | X | |
| dwReason; | X | |
| dwCompletionID; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwCountryCode; | X | |
| dwTrunk; | X | |
| dwCallerIDFlags; | X | |
| dwCallerIDSize; | X | |
| dwCallerIDOffset; | X | |
| dwCallerIDNameSize; | X | |
| dwCallerIDNameOffset; | X | |
| dwCalledIDFlags; | X | |
| dwCalledIDSize; | X | |
| dwCalledIDOffset; | X | |
| dwCalledIDNameSize; | X | |
| dwCalledIDNameOffset; | X | |
| dwConnectedIDFlags; | X | |
| dwConnectedIDSize; | X | |
| dwConnectedIDOffset; | X | |
| dwConnectedIDNameSize; | X | |
| dwConnectedIDNameOffset; | X | |
| dwRedirectionIDFlags; | X | |
| dwRedirectionIDSize; | X | |
| dwRedirectionIDOffset; | X | |
| dwRedirectionIDNameSize; | X | |
| dwRedirectionIDNameOffset; | X | |
| dwRedirectingIDFlags; | X | |
| dwRedirectingIDSize; | X | |
| dwRedirectingIDOffset; | X | |
| dwRedirectingIDNameSize; | X | |
| dwRedirectingIDNameOffset; | X | |
| dwAppNameSize; | X | |
| dwAppNameOffset; | X | |
| dwDisplayableAddressSize; | X | |
| dwDisplayableAddressOffset; | X | |
| dwCalledPartySize; | X | |
| dwCalledPartyOffset; | X | |
| dwCommentSize; | X | |
| dwCommentOffset; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwUserUserInfoSize; | X | |
| dwUserUserInfoOffset; | X | |
| dwHighLevelCompSize; | X | |
| dwHighLevelCompOffset; | X | |
| dwLowLevelCompSize; | X | |
| dwLowLevelCompOffset; | X | |
| dwChargingInfoSize; | X | |
| dwChargingInfoOffset; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI rellena los campos de tamaño y desplazamiento para los miembros dwAppNameSize/Offset, dwCalledPartySize/Offset y dwCommentSize/Offset y actualiza el valor de dwUsedSize para reflejarlos después de llamar al proveedor de servicios.
Después de que el proveedor de servicios vuelva de la función TSPI_lineGetCallInfo , TAPI establece el miembro dwCallStates de la estructura LINECALLINFO de la siguiente manera:
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
Si el proveedor de servicios modela líneas como "grupos" de recursos de canal y realiza la multiplexación inversa de una llamada a través de varios identificadores de dirección, debe elegir de forma coherente uno de estos identificadores de dirección como identificador principal notificado por esta función en la estructura de datos LINECALLINFO .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |