Share via

función TSPI_lineGetCallInfo (tspi.h)

  • Artículo

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